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1. Orange Pi 3 的 基本 特性 


1. 1 什么 是 Orange Pi 3 

香 权 派 是 一 秋 开 源 的 单 板 卡片 电脑 ,新 一 代 的 arm64 开 发 板 , 它 可 以 运行 Android 
7.0、Ubuntu 和 Debian 等 操作 系统 。 香 权 派 开发 板 〈Orange Pi3) 使 用 全 志 H6 系 
统 级 芯片 ， 同 时 拥有 1GB/2GB LPDDR3 内 存 


1.2. Orange Pi 3 的 用 途 


我 们 可 以 用 它 搭 建 : 


一 个 无 线 网 络 服务 器 
游戏 机 

音乐 播放 器 

高 清 视频 播放 器 
扬声器 

Android 


当然 还 有 其 他 更 多 的 功能 ， 因 为 0range Pi 是 开源 的 


1. 3 Orange Pi 3 是 为 谁 设 计 的 


Orange Pi 开发 板 不 仅仅 是 一 款 消费 品 , 同时 也 是 给 任何 想 用 技术 来 进行 创作 创 
新 的 人 设计 的 。 它 是 一 款 非 常 简单 、 有 趣 、 实 用 的 工具 ， 你 可 以 用 它 去 打造 你 身边 
的 世界 
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1. 4 Orange Pi 3 的 硬件 特性 
硬件 特性 介绍 

CPU 志 了 6 四 核 64 位 1.8GHz 高 性 能 Cortex-A53 处 理 器 
本 。High-performance multi-core GPU Mali 工 720 

。OpenGL ES3.1/3.0/2.0/1.1 
内 存 1GB/2GB LPDDR3 (与 GPU 共享 ) 
板 载 存储 TF 卡 插 槽 、8GB EMMC 〈 空 贴 EMMC 的 版 本 没有 ) 
以 太 网 RITL8211E 芯片 ， 文 持 10/0100M/1000M 以 太 网 
WIFI+ 蓝 牙 。AP6256 芯片 、 支 持 IEEE 802.11 ayb/g/mm/ac、BT5.0 
人 。 Re 0 lane 

。Complies with PCI Express Base 2.0 Specification 
视频 输出 HDMI 2.0a 、TV CVBS output 
音频 输出 HDMI 输出 、3.Smnm 音频 口 
电源 DC 电源 、Micro USB 接口 输入 
电源 管理 芯片 AXP805 
USB 端口 4 个 USB 3.0HOST、1 个 USB 2.0 HOST、1 个 OTG 接口 
26pin 接头 带 有 ICxl、SPIx1、UARTx1l 以 及 多 个 GPIO 口 
调试 串口 UARTTX、UARTRX 以 及 GND 
LED 灯 电源 指示 灯 和 状态 指示 灯 
红外 接收 支持 红外 遥控 器 
按键 电源 按键 (CSW4) 
文 持 的 操作 系统 Android7.0、Ubuntu、Debian 等 操作 系统 

外 观 规格 介绍 
产品 尺寸 90mmx64mm 
量 7Sg 
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1.5. Orange Pi 3 的 顶层 视图 和 底层 视图 


顶层 视图 : 


】 7 


底层 视图 : 


AP&Q 人 
1636 CQ-4047-0。 二 
162264 
ee - 
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1.6. Orange Pi 3 的 接口 详情 图 


1.6.1. 带 8GBEMMC 版 本 


@ 全 志 H6 
(ARM ”Cortex -A53 四 核 1.8GHZ ) 64 位 


1GB/2GB LPDDR3 


26Pin 扩展 接口 红外 线 接收 | USB3.0 HUB 芯 片 


2 个 USB3.0 
电源 (5V/2ADC ) 
干 兆 网 口 芯片 
USB OTG+ 供 电 
En 千 兆 网 品 
WiFi+ 蓝 牙 
meD 一 WiFi 天 线 
考 克 一 舍 一 
有 站 忆 人 和 2 个 USB3.0 
USB2.0 
PCIE 接 口 耳机 
oa TF 卡 模 
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1.6.2. 不 带 8GB EMMC 版 本 
”顶层 视图 


志 
@ 全 二 6 本 
(ARM “Cortex -A53 四 核 1.8GHZ ) 64 位 


2 个 USB3.0 
电源 (5V/12ADC 
干 兆 网 口 芯片 
USB OTG+ 供 电 
电源 开关 键 干 兆 网 品 
站 WiFi+ 蓝 牙 
调试 串口 一 4 WiFi 天 线 
才 克 风 一 人 二 让 < VE 
.全 | 省 人 2 个 USB3.0 
| 了 | 到 |, 久 :| 把 汪汪 
USB2.0 
PCIE 接 品 耳机 
TF 卡 模 
- 93.5mm 
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2. 开发 板 使 用 介绍 


2. 1 准备 需要 的 配件 


1) TF 卡 , 最 小 8GB 容量 的 elass10 级 以 上 的 高 速 卡 , 建议 使 用 闪 迪 的 TF 卡 , Orange 
Pi 测试 都 是 使 用 内 迪 的 TF 卡 ， 其 他 牌子 的 TF 卡 可 能 会 出 现 系统 无 法 启动 的 问题 


SamnDisk 闪 迪 


SanD)isKk 
LU/tra 


16GB 站 
人 @@41 I 


2) TF 卡 读 卡 器 ， 用 于 读 写 TF 卡 


js 


3) HDMI 转 HDMI 连接 线 ， 用 于 将 开发 板 连 接 到 HDMI 显示 器 或 者 电视 进行 显示 


4) 电源 适配器 ，SV/2A 或 者 SV/3A 的 高 品质 电源 适配器 ， 开 发 板 的 Micro USB 接 
口 也 可 以 用 于 电源 输入 
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电源 5V3A 接头 4.0*1.7mm 


$) USB 接 口 的 鼠标 和 键盘 ， 只 要 是 标准 USB 接 口 的 鼠标 和 键盘 都 可 以 ， 鼠 标 和 键盘 
可 以 用 来 控制 Orange Pi 开发 板 


6) 红外 遥控 器 ， 主 要 用 于 控制 安 卓 系 统 


香 橙 派 


红外 和 运 接 更 
EESEEEEEES- . 


下 


2 
vaos _0 san 


iDroid 


7) 百 兆 或 者 千 兆 网 线 ， 用 于 将 开发 板 连接 到 因特网 


8) AV 视频 线 ， 如 果 和 希望 通过 CVBS 接口 而 不 是 HDMI 接口 来 显示 视频 ， 那 么 就 需 
要 通过 AV 视频 线 将 开发 板 连 接 到 电视 


N 


适用 各 种 电视 


9) USB 转 TTL 模块 和 杜邦 线 ， 使 用 串口 调试 功能 时 ， 需 要 USB 转 TIL 模块 和 杜 
邦 线 来 连接 开发 板 和 电脑 
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10) 安装 有 Ubuntu 和 Windows 操作 系统 的 个 人 电脑 


1 Ubuntul14.04 PC | 可 选 ， 用 于 编译 Android 源码 

包 Ubuntul18.04 PC | 可 选 ， 用 于 编译 Linux 源码 

3 Windows PC 用 于 烧 录 Android 和 Linux 镜像 
2. 2. 下 载 开 发 板 的 镜像 和 相关 的 资料 


1) 中 文 版 资料 的 下 载 网 址 为 


http: 人 www.orangepi.cn/downloadresourcescny/ 


贷 OrangePi 3 
Android 源 码 Linux 源码 用 户 手册 和 原理 图 《 官方 工具 
更 新 : 2019-12-16 学 更 新 : 2019-12-46 更 新 : 2019-12-16 SN 更 新 : 2019-12-16 
Android 镜 像 Ubuntu 镜像 Debian 镜 像 Armbian 镜 像 
硕 更 新 : 2019-12-16 鼻 理 新 : 2019-12-16 @ 更 新 : 2019-12-16 更 新 : 2019-12-16 
英文 版 资料 的 下 载 网 址 为 
2) 版 资料 的 下 载 网 址 关 
http:/www.orangepli.org/downloadresources/ 
并 Orange Pi 3 
Android Source Code Linux Source code User Manual Office Tools 
updated-2019-12-31 updated-2019-12-31 Updated-2019-12-31 ee ated-2019-12-31 
了 ET JEET3 代 
Android Image Ubuntu Image Debian Image Armbian 
般 汪汪 updated:2019-12-31 咎 六 Updated-2019-12-31 updated:2019-12-31 updated:2019-12-31 
了 EETD 


3) 资料 主要 包含 
a Android 源码 : 保存 在 百度 云 盘 和 谷歌 网 盘 上 
b.， Linux 源码 : 保存 在 github 上 ， 链 接地 址 为 


https:/github.comy/orangepi-xunlong/orangepli-build 
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用 户 手册 和 原理 图 : 芯片 相关 的 数据 手册 也 会 放 在 这 里 

官方 工具 : 主要 包括 开发 板 使 用 过 程 中 需要 用 到 的 软件 

Android 镜像 : 保存 在 百度 云 盘 和 谷歌 网 盘 上 

Ubuntu 镜像 : 保存 在 百度 云 盘 和 谷歌 网 盘 上 

Debian 镜像 : 保存 在 百度 云 盘 和 谷歌 网 盘 上 

Armbian 镜像 链接 ， 由 Armbian 社区 开发 和 维护 的 镜像 ， 使 用 过 程 中 如 果 
遇 到 问题 ， 请 先 去 armbian 论坛 反馈 ，Armbian 镜像 的 维护 者 以 及 其 他 使 用 
Armbian 镜像 的 人 会 协助 解决 各 种 问题 ， 这 是 解决 问题 最 快 的 方法 。Orange 
Pi 不 负责 维护 这 个 镜像 


局 mo Se 


2. 3， 使 用 eMMC 中 预 装 的 安 齐 镜像 测试 开发 板 的 功能 


如 果 购 买 的 是 带 有 8GB eMMC 版 本 的 Orange Pi 3 开发 板 ， 拿 到 开发 板 后 ， 可 
以 先 使 用 eMMC 中 预 装 的 Android 镜像 测试 开发 板 的 功能 ,确定 开发 板 所 有 硬件 功 
能 都 没 问题 后 ， 再 烧 录 自己 想 使 用 的 系统 


2. 4， 基于 Windows PC 将 Linux 镜像 烧 写 到 TEF 卡 的 方法 


1) 首先 准备 一 张 8GB 或 更 大 容量 的 TF 卡 ，TEF 卡 的 传输 速度 必须 为 class10 以 上 ， 
建议 使 用 闪 迪 等 品牌 的 TF 卡 


2) 然后 使 用 读 卡 器 把 TF 卡 插入 电脑 


3) 接着 格式 化 TF 卡 
a 可 以 使 用 SD Card Formatter 这 个 软件 格式 化 TF 卡 ， 其 下 载 地 址 为 


https:/www.sdcard.org/downloads/formattereula windows/SDCardFormattervS WinEN.zip 


b.， 下 载 完 后 直接 解压 安装 即 可 ， 然 后 打开 软件 


c. 如 果 电 脑 只 插入 了 TE 卡 ， 则 “Select card” 一 栏 中 会 显示 TFE 卡 的 盘 符 ， 如 
果 电 脑 插 入 了 多 个 USB 存储 设备 ， 可 以 通过 下 拉 框 选择 TF 卡 对 应 的 盘 符 
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d. 


@. 


国 SD card Formatter 尖 
File Help 
Select card 
区 本 国人 v 
Refresh 


Cardinformation 
下 


sorc 二 2 
Capaaty 14.84GB 
Formatting options 
图 Quidformat 
CO) overwrite format 


CHS format size adjustment 


Volume label 


Eee 


SD Logo, SDHC Logo and SDXC Logo are trademarks of SD-3C, LLC, 


有 限 公司 版 权 所 


有 


然后 点 击 “Format”， 格 式 化 前 会 弹出 一 个 警告 框 ， 选 择 “ 是 (Y) ”后 就 会 


开始 格式 化 


SD Card Formatter 
Formatting will erase all data on this card 
Do you want to continue? 
Note: As formatting can take some time (especially when overwrite 


option is selected), please make surethat your computer is connected 
to a power supply and that sleep mode is disabled. 


E 


格式 化 完 TF 卡 后 会 弹出 下 图 所 示 的 信息 ， 点 击 确定 即 可 


SD Card Formatter 藉 


全 Formatting was successfully completed. 


Volume informationr: 

File system: FAT32 

Capacity: 14.83 GB6 (15,923,150,848 bytes) 
Free space: 14.83 GB (15,923,118,080 bytes) 
Cluster size: 32 kilobytes 

Volume label: 


4) 从 Orange Pi 的 资料 下 载 页 面 下 载 想 要 烧 录 的 Linux 操 作 系 统 镜像 文件 压缩 包 
后 使 用 解压 软件 解压 ， 解 压 后 的 文件 中 ， 以 “. img” 结 尾 的 文件 就 是 操作 系统 的 镜 
像 文件 ， 大 小 一 般 都 在 16B 以 上 


5) 使 用 Win32Diskimager 煤 录 Linux 镜像 到 TF 卡 


3. 


Win32Diskimager 的 下 载 页 面 为 
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http:/Sourceforge.net/projects/win32diskimagerfiles/Archive/ 


b. 下 载 完 后 直接 安装 即 可 ，Win32Diskimager 界面 如 下 所 示 
a) 首先 选择 镜像 文件 的 路 径 
b) 然后 确认 下 TF 卡 的 盘 符 和 “设备 ”一 栏 中 显示 的 一 致 
c) 最 后 点 击 “ 写 入 ” 即 可 开始 烧 录 


伍 Win32 磁盘 映像 工具 - 1.0 一 
映像 文件 

| ] 
核验 值 


无 7| 竺 成 | | 复制 


， 选择 TF 卡 
选择 镜像 文件 的 盘 符 
仅 读 取 已 分 本 分 区 
任务 进度 
开始 烧 写 镜像 
取消 读 仅 核验 退出 
等 待 任务 完成 。 


c.， 镜像 写 入 完成 后 ， 点 击 “ 退 出 ”按钮 退出 即 可 ， 然 后 就 可 以 拔 出 TF 卡 插 到 开 
发 板 中 局 动 


2.5. 基于 Ubuntu PC 将 Linux 镜像 烧 写 到 TEF 卡 的 方法 


1) 首先 准备 一 张 8GB 或 更 大 容量 的 TF 卡 ，TF 卡 的 传输 速度 必须 为 lass10 以 上 ， 
建议 使 用 闪 迪 等 品牌 的 TF 卡 


2) 然后 使 用 读 卡 器 把 TF 卡 插入 电脑 


3) 下 载 balenaEtcher 软件 ， 下 载 地 址 为 


https:/www.balena.io/etcher/ 


4) 进入 balenaEtcher 下 载 页 面 后 ， 请 通过 下 拉 框 选择 Linux 版 本 的 软件 进行 下 载 
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二 


Select image 


Downtload for Windows (x86|x64) 人 


Etcherfor Windows (x86|x64) {fPortable) 


EtcherformacOsS 


Etcherfor Linuxx64 (64-bit) (Applmage) 


EtcherforLinuxx86 (32-bit) (Applmage) 


5$) 下 载 完 后 使 用 unzip 进行 解压 , 解压 后 的 balenaEtcher-1.S.109-x64.AppImage 惑 
是 烧 录 Linux 镜像 需要 的 软件 


testtest:~$ unzip balena-etcher-electron-1.S.109-linux-x64.zip 


Archive: balena-etcher-electron-1.3.109-linux-x64.zip 
inflating: balenaEtcher-1.9.109-x64.AppImasge 
test@Qtest:~$ ls 
balenaEtcher-1.S.109-x64.AppImage balena-etcher-electron-1.3.109-linux-x64.zip 


6) 从 Orange Pi 的 资料 下 载 页 面 下 载 想 要 烧 录 的 Linux 操作 系统 镜像 文件 压缩 包 ， 
然后 使 用 解压 软件 解压 ， 解 压 后 的 文件 中 ， 以 “.img” 结 尾 的 文件 就 是 操作 系统 的 
镜像 文件 ， 大 小 一 般 都 在 1GB 以 上 

a 7z 结尾 的 压缩 包 的 解压 命令 如 下 所 示 


testtest:~$ 7z x orangepi3 2.1.0 ubuntu _bionic _ server_ linux4.9.118.7z 


testtest:~$ ls orangepi3 2.1.0 ubuntu bionic_ server linux4.9.118.* 
orangepi3 2.1.0 ubuntu bionic _ Server linux4.9.118.7z 

orangepi3 2.1.0_ ubuntu bionic_ server linux4.9.118.img.sha  # 校 验 和 文件 
orangepi3 2.1.0 ubuntu _bionic server linux4.9.118.img 。 # 镜 像 文 件 


7) 解压 镜像 后 可 以 先 用 sha256sum -c *.sha 命令 计算 下 校 验 和 是 否 正确 ， 如 果 提 示 
成 功 说 明 下 载 的 镜像 没有 错 ， 可 以 放心 的 烧 录 到 TF 卡 ， 如 果 提 示 校 验 和 不 匹配 说 
明 下 载 的 镜像 有 问题 ， 请 尝试 重新 下 载 

testtest:~$ sha2S6Ssum -c *.sha 

orangepi3 2.1.0_ ubuntu bionic _server_linux4.9.118.img: 成 功 


8) 然后 在 Ubuntu PC 的 图 形 界面 双击 balenaEtcher-1.5.109-x64.AppImage 即 可 打开 
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balenaEtcher 〈 无 需 安装 ) ， 打 开 后 的 界面 如 下 图 所 示 
a. 首先 选择 linux 镜像 文件 的 路 径 
b.， 然后 选择 TF 卡 的 设备 号 
c. 最 后 点 击 Flash 开始 烧 录 


9) 烧 录 过 程 会 提示 写 入 的 速度 和 剩余 时 间 
Etcher - 34% Flashing... 


balena 


昌 一 一 昌 


oOrangepip....4.65.img Mass Stor...E08-042F) Flashing,.. 


10) 烧 录 完 后 会 显示 下 面 的 界面 , 此 时 就 可 以 把 TF 卡 从 电脑 中 拔 出 来 插 到 开发 板 中 
局 动 了 
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Ekcher 


Flash Completel Flash Another 


Thanks for using 靖 balena 


2.6， 烧 写 Linux 镜像 到 eMMC 中 的 方法 
见 烧 写 linux 镜像 到 eMMSC 的 方法 
2.7. 烧 写 Android 固件 到 TF 卡 的 方法 


Android 镜像 只 能 在 Windows 平台 下 使 用 PhoenixCard 软件 烧 录 到 TEF 卡 中 ， 
在 Linux 平台 下 无 法 烧 录 


1) 首先 准备 一 张 8GB 或 更 大 容量 的 TFE 卡 ，TF 卡 的 传输 速度 必须 为 class1l0 以 上 ， 
建议 使 用 闪 迪 等 品牌 的 TF 卡 


2) 然后 使 用 读 卡 器 把 TF 卡 插入 电脑 


3) 从 Orange Pi 的 资料 下 载 页 面 下 载 Android7.0 的 固件 和 PhoenixCard 烧 写 工具 ， 
请 确保 PhonenixCrad 工具 的 版 本 为 PhoenixCard v4. 1.2 


3) 使 用 解压 软件 解压 下 载 的 Android 固件 的 压缩 包 ,， 解压 后 的 文件 中 ， 以 “. img” 
结尾 的 文件 就 是 Android 固件 


4) 使 用 解压 软件 解压 PhoenixCard v4. 1. 2.rar， 此 软件 无 需 安 装 ， 在 解压 后 的 文 
件 夹 中 找到 PhoenixCard 打开 即 可 


Www.orangepi.cn 14 Www.Xxunlong.tv 


上 range Pi 用 户 手册 深圳 市 迅 龙 软 件 有 限 公 司 版 权 所 有 


1] option.cfg 2017/6/27 16:53 CFG 文件 T KB 
图 parserManagerdll 2017/76/28 17:51 应 用 程序 扩 层 81 KB 
向] PhoenixCard ManualV4.1.1 2017/7/5 15:05 DOC 文档 382 KB 
坑 phoenixCard 2017/10/25 15:03 订 742 KB 
_ | PhoenixCard.lan 2017/10/25 15:16 LAN 文件 3 KB 
| ] phoenixcard,pdb 2017/10/25 15:;03 PDB 文件 22.971 KB 


。 打开 PhoenixCard 后 ， 如果 TF 卡 识别 正常 ， 会 在 中 间 的 列表 中 显示 TF 卡 的 盘 符 
和 容量 ， 请 务必 确认 显示 的 盘 符 和 你 想 烧 录 的 TF 卡 的 盘 符 是 一 致 的 ， 如 果 没 有 显 
示 可 以 尝试 拔 插 下 TF 卡 


寺 PhoenixCard V4.1.2 


固件 
制作 卡 的 种 类 
口 旺 产 卡 轩 户 动 卡 口 烧 Key 卡 


烧 卡 恢复 卡 


列表 《请 确保 插入 需要 烧 写 的 卡 ， 并 找 出 其 他 移动 存 傅 设备 》 
选择 盘 符 容 里 


15193M 


6) 确认 完 盘 符 后 ， 先 格式 化 TE 卡 ， 点 击 PhoenixCard 中 恢复 卡 按钮 即 可 ， 也 可 以 
使 用 前 面 提 到 的 SD Card Formattet 进行 TF 卡 的 格式 化 


导 PhoenixCard V4.1.2 


固件 | 


制作 卡 的 种 类 


列表 《请 确保 插入 需要 烧 写 的 卡 ， 并 拔 出 其 他 移动 存 铺 设备 》 


输出 信息 


7) 然后 开始 将 Android 固件 写 入 TF 卡 
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a， 首先 在 “ 国 件 ”一 栏 中 选择 Android 固件 的 路 径 

b， 在 “制作 卡 的 种 类 ”中 选择 “启动 卡 ” 

c， 然后 点 击 “ 烧 卡 ” 按 钮 就 会 开始 烧 录 

志 phoenixCard V4.1.2 X 


固件 一 1. 选择 Android 辕 件 的 路 径 ，Android 固 件 是 以 ,img 结尾 的 文件 


制作 卡 的 种 类 


2. 烧 录 到 TF 卡 需要 选择 启动 下 
列表 《请 确保 插入 需要 烧 写 的 卡 ， 并 拔 出 其 他 移动 存 情 设备 ) 3. 点 击 开 卡 开 始 烧 录 镜像 到 TF 卡 


选择 蝶 符 容 旦 状态 | 


显示 烧 写 进度 


葵 出 信息 
Message 


E: 正在 格式 化 卡 …。 
E: 开始 烧 写 .…. 

E: [ 喷 写 第 一 部 分 ] 央 写 完成 

E [了 第 五 部 做 与 交 成 | we。 局 示 烧 写 过 程 的 输出 信息 


局 [MBR] 烧 写 完成 

E: [bootloaden] 晓 写 完 成 
E: [env] 烧 写 完 成 

E [boob 烧 写 充 成 


清除 消息 帮助 版 本 更 新 关闭 


8) 烧 录 完 后 PhoenixCard 的 显示 如 下 图 所 示 ， 此 时 点 击 关 闭 按钮 即 可 退出 
PhoenixCard， 然 后 就 可 以 把 TF 卡 从 电脑 中 拔 出 来 插 到 开发 板 中 启动 了 
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列表 《请 确保 插入 需要 烧 写 的 卡 ， 并 找 出 其 他 移动 存 倩 设备 》 


绿色 表示 烧 写 完成 


输出 信息 
| Messaoe 人 
E: [boot 懂 写 完 成 
E: [System] 懂 写 完 成 
E: [misc] 烧 写 完 成 
E: [recovery] 烧 写 完 成 
E: [sysrecovery] 烧 写 完 成 
E: [DATA File] 烧 写 完 成 
E: magic 完 成 显示 烧 写 结束 ， 没 有 错误 点 击 关闭 退出 


放生 一 
区 SIE 5 
者 人 消息 盖 版 本 重新 


2.8. 烧 写 Android 固件 到 eMMSC 中 的 方法 


Android 镜像 只 能 在 Windows 平台 下 使 用 PhoenixCard 软件 烧 录 到 EMIMC 中 ， 
在 Linux 平台 下 无 法 烧 录 


1) 首先 请 注意 ， 将 Android 固件 烧 录 到 开发 板 的 eMMSC 中 需要 借助 TF 卡 来 完成 ， 
主要 分 为 如 下 两 步 

a. 先 使 用 PhoenixCard 将 Android 固件 以 量 产 卡 的 方式 烧 录 到 TF 卡 中 

b. 然后 使 用 TF 卡 将 Android 固件 烧 录 到 eMMC 中 


2) 先 准备 一 张 8GB 或 更 大 容量 的 TF 卡 ，TF 卡 的 传输 速度 必须 为 classl0 以 上 ， 建 
议 使 用 闪 迪 等 品牌 的 TF 卡 


3) 然后 使 用 读 卡 器 把 TF 卡 插 入 电脑 


4) 从 Orange Pi 的 资料 下 载 页 面 下 载 Android 7.0 的 固件 和 PhoenixCard 烧 写 工具 ， 
请 确保 PhonenixCrad 工具 的 版 本 为 PhoenixCard v4.1.2 


5) 使 用 解压 软件 解压 下 载 的 Android 固件 的 压缩 包 ， 解 压 后 的 文件 中 ， 以 “.img” 
结尾 的 文件 就 是 Android 固件 
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6) 使 用 解压 软件 解压 PhoenixCard v4. 1. 2.rar， 此 软件 无 需 安装 ， 在 解压 后 的 文 
件 夹 中 找到 PhoenixCard 打开 即 可 

_] option.cfg 

图 parserManager.dll 
PhoenixCard ManualV4.1.1 
寺 PhoenixCard 

_| PhoenixCard.lan 
_] PhoenixCard.pdb 


下 


， 打开 PhoenixCard 后 ， 如果 TF 卡 识别 正常 ， 会 在 中 间 的 列表 中 显示 TF 卡 的 盘 符 
和 容量 ， 请 务必 确认 显示 的 盘 符 和 你 想 烧 录 的 TF 卡 的 盘 符 是 一 致 的 ， 如 果 没 有 显 


示 可 以 党 试 拔 插 下 TF 卡 
导 PhoenixCard V4.1.2 屎 
证 | | 
制作 卡 的 种 类 
图 旦 产 卡 口 启动 卡 口 烧 Key 卡 烧 卡 恢复 卡 


列表 《请 确保 插入 需要 烧 写 的 卡 ， 并 找 出 其 他 移动 存储 设备 ) 


8) 确认 完 盘 符 后 ， 先 格式 化 TFE 卡 ， 点 击 PhoenixCard 中 恢复 卡 按钮 即 可 ， 也 可 以 
使 用 前 面 提 到 的 SD Card Formattet 进行 TF 卡 的 格式 化 
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响 phoenixCard V4.1.2 X 
固件 | 
制作 卡 的 种 类 
圈 蛙 产 卡 口 启 动 卡 口 烧 Key 卡 烧 卡 恢复 卡 
列表 《请 确保 插 久 需要 烧 写 的 卡 ， 并 找 出 其 他 移动 存 倩 设备) 
选择 | 级 符 | 容 里 | 状态 
9) 然后 开始 将 Android 固件 写 入 TF 卡 
a。 首先 “固件 ”一 栏 中 选择 Android 固件 的 路 径 
b， 在 “制作 ” 卡 的 种 类 中 选择 “ 量 产 卡 ” 
c.， 然后 点 击 “ 烧 卡 ” 按 钮 就 会 开始 烧 录 
19 Www.Xxunlong.tv 


Www.orangepli.cn 


艺 range Pi 用 户 手册 深圳 市 迅 龙 软 件 有 限 公 司 版 权 所 有 


棱 PhoenixCard V4.1.2 藉 
司 昌 | 1. 选 择 Android 固 件 的 路 径 ，Android 固 件 是 以 jimg 结 尾 的 文件 
制作 卡 的 种 类 

2. 选择 量 产 卡 


列表 《请 确保 插入 需要 烧 写 的 卡 ， 并 找 出 其 他 移动 存储 设备 3 志 击 烧 卡 开始 烧 录 


显示 烧 写 的 进度 


输出 信息 


守成 | ww。 显示 烧 录 过 程 的 输出 信息 


E: [bootloade] 烧 写 完 成 


者 全 消息 天助 | 抽 量 帮 || 。。 关 闭 


10) 烧 录 完 后 PhoenixCard 的 显示 如 下 图 所 示 ， 此 时 点 击 关 闭 按钮 即 可 退出 


PhoenixCard 


列表 《请 确保 插入 需要 烧 写 的 卡 ， 并 拔 出 其 他 移动 存储 设备 ) 
选择 | 引 符 | 容 旦 | 状态 


加 国 国 


绿色 表示 烧 写 完成 


输出 信息 

Message 

E: [ 晓 写 第 一 部 分 ] 烧 写 完 成 

E: [ 晓 写 第 五 部 分 ] 峡 写 完 成 

E: [MBR] 烧 写 完 成 

E: [bootloaden] 晓 写 完 成 es 

E: [IMG File] 烧 写 完 成 点 击 关闭 退出 
E: [DATA File] 烧 写 完成 


E: magic 完 成 
-Am 一 显示 烧 写 结束 ， 没 有 提示 错误 v 
> 


| 丘 烧 写 结束 …| 
世 
清除 消息 | 盖 版 本 更 新 上 L 兽 | 


11) 然后 将 TF 卡 插入 开发 板 ， 上 电 局 动 开发 板 后 会 自动 将 TF 卡 中 的 Android 固件 
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烧 录 到 开发 板 的 eMMC 中 ， 如 果 开 发 板 连接 了 HDMI 显示 器 ， 在 HDMI 显示 器 上 
会 显示 烧 录 Android 固件 到 eMMSC 的 进度 条 


12) 烧 录 完成 后 HDMI 的 显示 如 下 图 所 示 ， 然 后 开发 板 会 自动 关机 


13) 此 时 就 可 以 拔 出 TF 卡 ， 然 后 重新 上 电 ， 就 会 司 动 aeMMC 中 的 Android 系统 了 


2. 9 局 动 香 橙 派 开 发 板 


1) 将 烧 录 好 镜像 的 TF 卡 插入 香 栖 派 开发 板 的 TF 卡 插 槽 中 

2) 开发 板 有 HDMI 接口 ， 可 以 通过 HDMI 转 HDMI 连接 线 把 开发 板 连接 到 电视 或 
者 HDMI 显示 器 

3) 接 上 USB 鼠标 和 键盘 ， 用 于 控制 香 栖 派 开发 板 

4) 开发 板 有 以 太 网 口 ， 可 以 插入 网 线 用 来 上 网 
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5) 连接 一 个 SV/2A 〈5V/3A 的 也 可 以 ) 高 品质 的 电源 适 配 
a. 切记 不 要 插入 12V 的 电源 适配器 ， 如 果 插 入 了 12YV 的 电源 适配器 ， 会 烧 坏 
开发 板 
b. 系统 上 电 启 动 过 程 中 很 多 不 稳定 的 现象 基本 都 是 供电 有 问题 导致 的 ， 所 以 
一 个 靠 谱 的 电源 适配器 很 重要 
6) 然后 打开 电源 适配器 的 开关 , 如 果 一 切 正常 ,此 时 HDMI 显示 器 就 能 看 到 系统 的 
启动 画面 了 
7) 如 果 想 通过 调试 串口 查看 系统 的 输出 信息 ， 请 使 用 USB 转 TTL 模块 和 杜邦 线 将 
开发 板 连 接 到 电脑 ， 串 口 的 连接 方法 请 参看 调试 串口 的 使 用 方法 一 节 


2. 10. 调试 串口 的 使 用 方法 


2. 10. 1. 调试 串口 的 连接 说 明 


1) 首先 需要 准备 一 个 USB 转 TTL 模块 ， 此 模块 在 Orange Pi 的 店铺 中 可 以 买 到 ， 
如 果 有 其 他 类 似 的 USB 转 TTL 模块 也 可 以 ， 然 后 将 USB 转 TTL 模块 的 USB 接口 
一 端 插 入 到 电脑 的 USB 接口 中 


香 杰 派 多 /USB 转 TTL 模 鼠 


USB 转 TTL 模 块 的 3.3V 不 需要 接 
。 USB 转 TTL 模 块 的 TXD 接 开发 板 调试 串口 的 RXD 
。 USB 转 TTL 模 块 的 RXD 接 开发 板 调试 串口 的 TXD 
USB 转 TTL 模 块 的 GND 接 开发 板 调试 串口 的 GND 
USB 转 TTL 模 块 的 5V 不 需要 接 


2) 开发 板 的 调试 串口 GND、TX 和 RX 引 脚 的 对 应 关系 如 下 图 所 示 


Www.orangepl.cn 22 WwWw.Xunlong.tv 


也 range Pi 用 户 手册 深圳 市 迅 龙 软 件 有 限 公 司 版 权 所 有 


AL CND 


4 


TITTT 
自 = 


3) USB 转 TTL 模块 GND、TX 和 了 RX 引 脚 需要 通过 杜邦 线 连 接 到 开发 板 的 调试 串 
口上 
a USB 转 TITL 模块 的 GND 接 到 开发 板 的 GND 上 
b，USB 转 TTL 模块 的 RX 接 到 开发 板 的 TX 上 
c， USB 转 TITL 模块 的 TX 接 到 开发 板 的 RX 上 


4) USB 转 TTL 模块 连接 电脑 和 Orange Pi 开发 板 的 示意 图 如 下 所 示 
使 用 杜邦 线 连接 


Orange Pi 开发 板 


USB 接 口 1 2 RxD “ 油 试 串口 
< > 攻 c 


USB 转 TTL 模 块 连接 电脑 和 Orange Pi 开发 板 的 示意 图 


2. 10. 2. Ubuntu 平台 调试 串口 的 使 用 方法 


1D) 如 果 USB 转 TTL 模块 连接 正常 ， 在 Ubuntu PC 的 /dev 下 就 可 以 看 到 对 应 的 设备 
节点 名 ， 记 住 这 个 节点 名 ， 后 面 设 置 串口 软 件 时 会 用 到 


Itest@test:~$ ls /dewttyUSB* 
dewttyUSB0 


2) linux 下 可 以 使 用 的 串口 调试 软件 有 很 多 ， 如 putty、minicom 等 ， 下 面 演示 putty 
的 使 用 方法 
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3) 首先 在 Ubuntu PC 上 安装 putty 


testtest:~$ sudo apt update 
testtest:~$ sudo apt install putty 


4) 然后 运行 putty， 记 得 加 sudo 权限 


testtest:~$ sudo putty 


5) 执行 putty 命令 后 会 弹出 下 面 的 界面 


PuTTY Configuration - D 多 


Category: Basicoptions foryour PUTTY Session 
Specify the destination you want to connect to 


Logging HostName (orIPaddress) Port 
Terminal 22 

Keyboard Connection type': 

Bell Raw Telnet Rlogin ”加 SSsH Serial 


Features Load,saveor deletea stored session 


7 window Saved Sessions 
Appearance 
Behaviour 
Translation Defautt Settings Load 
Selection 
Colours 


Save 


Fonts Delete 


Connection 
Data 
Proxy 
Telnet 
Rlogin 

hh SSH 


Close window on exit: 
四 Always Never Ontyon clean exit 


About Open Cancel 


6) 首先 选择 串口 的 设置 界面 
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PuTTY Configuration -- 口 
Category: Options controllinglocalseriallines 
Logging Selecta serialline 
= Terminal 
Serialline to connectto 
Keyboard 
Beltl | Configure the serialline 
Features Speed (baud) 9600 
Window 
Appearance Data bits 8 
Behaviour Stop bits 1 
Translation 
Selection Parnty Ce 忆 
Colours Flow control XON/XOFF 
Fonts 
Y Connection 
Data 
Proxy 
Telnet 
Rlogin 
< 首先 选择 串口 的 设置 界面 
About Open Cancel 


7) 然后 设置 串口 的 参数 


3. 


设置 Serial line to connect to 为 /dewttyUSB0 〈 修 改 为 对 应 的 节点 名 ， 一 般 为 
/dewttyUSB0 ) 

设置 Speed(baud) 为 115200〈 串 口 的 波 特 率 ) 

设置 Flow control 为 None 


PuTTY Configuration la 
Category: Options controlling localseriallines 
gong 2. 输 六 于 本 模块 的 设备 节点 名 <- 
0 Serialline to connect ko /dewttyUSB0 
Keyboard 
Bell Configure the serialline 
Features Speed (baud) | 115200| 
- wndow 3. 设 置 Speed(baud) 为 115200 ”二 
Appearance 
Behaviour Stop bits 
Transation 4. 设 串 Elow En 上 喇 
Selection 本 
Colours Elow control None 
Fonts 


Connection 
Data 


Proxy 


Telnet 1. 选择 串口 的 设置 界面 


Rlogin ee 


About Open Cancel 


8) 在 串口 的 设置 界面 设置 完 后 ， 再 回 到 Session 界面 
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n type 为 Serial 


b. 然后 点 击 Open 按钮 连接 串口 


Category: 


Logging 
Terminal 
Keyboard 
Bell 
Features 


T Window 
Appearance 
Behaviour 
Translation 

， selection 
Colours 
Fonts 

Connection 
Data 
Proxy 
Telnet 
Rlogin 

SSH 


About 


PuTTY Configuration 
[本 攻 >esslon 让 转 

Basicoptions foryour PUTTY Session 
Specify the destination youwant ko connect to 

Serialline Speed 


/dew/ttyusB0 115200 


Connection type: 

Raw Telnet Rlogin SSH 
Load, saveordelete astored 人 
Saved Sessions 、 ， 

二 2. 选择 Serial 


Default Settings Load 


Save 


Delete 


Close window on exit: 
和 @ Always Never Onlty on clean exit 


3. 最 后 点 击 Open 按 钮 ss 


ee 


9) 启动 开发 板 后 ， 就 能 从 打开 的 串口 终端 中 看 到 系统 输出 的 Log 信息 了 


/jdewttyusB0 - PuTTY 


2. 10. 3._ Windows 平台 调试 串口 的 使 用 方法 


口 调试 软件 有 和 上 很多， 如 SecureCRT、MobaXterm 等 ， 下 


1) Windows 下 可 以 使 用 的 虽 


面 演示 MobaXterm 的 使 用 方法 ， 这 款 软件 有 免费 版 本， 无 需 购买 序列 号 即 可 使 用 


2) 下 载 MobaXterm 
a. 下 载 MobaXterm 网 
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https:/mobaxterm.mobatek.net/ 


b.， 进入 MobaXterm 下 载 网 页 后 点 击 GET XOBATERM NOWV'! 
MobaXterm 


Enhanced terminal for Windows with X11 server tabbed SSH client, network tools and much more 


名 42. Solaris server 
门 aaeao 页 racem 旺 soymwp 癌 opeme 2 凡 加 


[了 FT 


舍 91 


eroytemt 


Remote desktop- use RDP VNC or XDMCP to display a full remote desktop on your computer 


c.， 然后 选择 下 载 Home 版 本 


Home Edition Professional Edition 


Free $69 / 49E per User 


*Excluding tax Volume discounts ayallabI 


FullX server and SSH support 
Remote desktop (RDP VNC, Xdmcp) 


Remote terminal (SSH, telnet, rlogin, Mosh) Every feature from Home Edition + 
X11-Forwarding Customize your startup message and logo 
Automatic SFTP browser Modify your profile script 
Master password protection Remove unwanted games, screensaver ortools 
Plugins support Uniimited number of sessions 
Portable and installer versions Unlimited number oftunnels and macros 
Full documentation Unlimited run time for network daemons 
Max. 12 sessions Enhanced security settings 
Max. 2 SSH tunnels 12-months updates included 
Max. 4 macros Deployment inside company 
Max. 360 seconds for Tftp, Nfs and Cron Lifetime rightto use 


d， 然后 选择 Portable 便携 式 版 本 ， 下 载 完 后 无 需 安装 ， 直 接 打开 就 可 以 使 用 


MobaXxterm Home Edition 


Download Mobaxterm Home Edfion (current version) 


Downioad previous stable version-。 MobaxXterm Portable v20.2 MobaxXterm Instalerv20 2 


You can also get early access to the latestfeatures and improvements by downloading MobaXterm Preview version 


By downloading MobaXterm software, you accept MobaXlerm 记 


and conditions 


You can download Mobaxterm and plugins sources herE 


fyou use MobaXterm inside your company you should consider subscribing to Mobayterm 
subscription will give you access to professional support and to the "Customizer” software_This customizer will allow you to 
generate personalized versions of MobaXterm including your own logo, your default settings and your welcome message 
Please conlactus for more information 


onal Edition- your 


3) 下 载 完 后 使 用 解压 缩 软件 解压 下 载 的 压缩 包 , 即 可 得 到 MobaXterm 的 可 执 软 件 ， 
然后 双击 打开 
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4) 打开 软件 后 ， 设 置 串 口 连接 的 步骤 如 下 
a. 打开 会 话 的 设置 界面 
b， 选择 串口 类 型 
c.， 选择 串口 的 端口 号 〈 根 据 实际 的 情况 选择 对 应 的 端口 号 ) ， 如 果 看 不 到 端口 
号 ， 请 使 用 360 驱动 大 师 扫描 安装 USB 转 TIL 串口 芯片 的 驱动 
d.， 选 择 串口 的 波 特 率 为 11$200 
e. 最 后 点 击 “OK” 按 钮 完成 设置 


@ X @ 
沁 Er6aEsE 
2. 选择 趾 空 
。。 1 .选择 会 话 ， 打 会 话 的 设置 界面 
和 ss 国立 
于 SSH Telnst Rsh Xdmcp ”RDP VNC FTP SFTP| 。 Serial File Shell Browser Mosh  Aws S3  WSL 


襄 Basic Serial settings 


得 

三 

术 Ce 
Serial pot*|CDM3 (Siicon Labs CP210x USBto UARTBH ~ Speed (bps) "|115200 ~ 


襄 Advanced Sehial 叶 图 Terminal settings 。 址 Bookmark settings 、 


3. 选择 串口 的 端口 号 4 . 选择 波 特 率 为 115200 
Serial (COM) session 乱 
5. 最 后 点 击 OK 
加 or 加 cancel 


UNREGTSTERED VERSION - Fease support MabaXtemm by subsoibing to the professional edition heres httpszJhncbaxtermmbatecnet 


5) 点 击 “OK” 按 钮 后 会 进入 下 面 的 界面 ， 此 时 局 动 开 发 板 就 能 看 到 串口 的 输出 信 
县 了 
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地 成 一 条 
W# | 会 话 记 录 ， 下 次 
直接 点 击 即 可 打开 


UNREGTSTERED VERSIOW - Reasesupport 


3. Linux 系统 使 用 说 明 


3. 1， 已 支持 的 linux 发 行 版 类 型 和 内 核 版 本 


发 行 版 类 型 内 核 版 本 服务 器 版 栗 面 版 
Ubuntu 18.04 linux4.9 支持 支持 
Ubuntu 20.04 linux4.9 支持 支持 

Debian 10 linux4.9 支持 支持 
Ubuntu 20.04 linux5S.4 支持 支持 
Debian 10 linuxS.4 支持 支持 


3. 2， linux4.9 内 核 驱 动 适 配 情况 


功能 状态 
HDMI 视频 OK 
HDMI 音频 OK 
USB3.0x4 OK 
USB2.0 OK 
TEF 卡 启动 OK 
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网 卡 OK 
红外 接收 OK 
WIFI OK 
蓝牙 OK 
耳机 音频 OK 
MIC 录音 OK 
USB 摄像 头 OK 
LED 灯 OK 
20pin GPIO OK 
IC OK 
SPI OK 
UART OK 
温度 传感器 OK 
硬件 看 门 狗 OK 
开关 机 按键 OK 
EMMC 启动 OK 
CVBS 视频 NO 
minl PCIE NO 
Mali GPU NO 
视频 编 解码 NO 

3.3， linux5.4 内 核 驱动 适 配 情况 

功能 状态 
HDMI 视频 OK 
HDMI 音频 OK 
USB3.0x4 OK 
USB2.0 OK 
TEF 卡 启动 OK 
网 卡 OK 
红外 接收 OK 
WIFI OK 
蓝牙 OK 
耳机 音频 NO 
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MIC 录音 NO 
USB 摄像 头 OK 
LED 灯 OK 
20pin GPIO OK 
IC OK 

SPI OK 
UART OK 
温度 传感器 OK 
硬件 看 门 狗 OK 
开关 机 按键 OK 
EMMC 启动 OK 
CVBS 视频 NO 
mini PCIE NO 
Mali GPU NO 
视频 编 解码 NO 


3. 4， linux 系统 默认 登录 账号 和 密码 


账号 冤 码 
root orangepl 
orangepl orangepl 


3. 5. Linux 桌面 版 系统 目 动 登录 说 明 


1) 桌面 版 系统 默认 局 动 后 会 自动 登录 进入 桌面 ， 无 需 输 入 密码 
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中 weuo 109 | 训 扩 币 ] onngepi 


S.E 
4 
nr 


2) 修改 /etcylightdnylightdm.confd/22-orangepi-autologin.conf 中 的 配置 可 以 禁止 桌面 
版 系统 自动 登录 桌面 ， 修 改 命 令 如 下 ， 也 可 以 打开 配置 文件 直接 修改 


root(Oorangepi:~##Sed -i"s/autologin-user=orangepi/#autologin-user=orangepi/" 


yetc/lightdmy/lightdm.conf.d/22-orangepi-autologin.conf 


3) 修改 完 后 /etclightdnylightdm.confd/22-orangepi-autologin.conf 的 配置 如 下 所 示 
root(Oorangepi:~ 和 # cat /etc/lightdmy/lightdm.conf.d/22-orangepi-autologin.conf 
[Seat:*] 

##tautologin-user=orangepi 


autologin-user-timeout=0 


user-SeSSlon=Xxfce 


4) 然后 重 局 系统 就 会 出 现 登录 对 话 框 ， 此 时 需要 输入 密码 才能 进入 系统 
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3. 6. 第 一 次 启动 自动 扩容 TF 卡 中 的 rootfs 


ID) TF 卡 第 一 次 启动 linux 系统 时 会 通过 orangepi-resize-filesystem.service 这 个 
systemd 服务 来 调用 orangepi-resize-filesystem 脚本 自动 进行 footg 的 扩容 ,所 以 无 需 
再 手动 扩容 


2) 登录 系统 后 可 以 通过 df -h 命令 来 查看 rootfs 的 大 小 ,如果 和 TF 卡 的 实际 容量 一 
致 ， 说 明 自 动 扩 容 运 行 正 确 


rootorangepi:~#df -h 

Filesystem Size Used Avail Use% Mounted on 

udev 430M 0 430M 0% /dev 
tmpf 100M 3.OM 93M 6% un 
dev/mmcblk0pl 1SG 9ISM 14G 792o/ 

tmpf 3S00M 0 300M ”09% /devshm 


3) 需要 注意 的 是 ，linux 系统 只 有 一 个 ext4 格式 的 分 区 ， 没 有 使 用 单独 的 BOOT 分 
区 来 存放 内 核 镜 像 等 文件 ， 也 就 不 存在 BOOT 分 区 扩容 的 问题 


4) 另外 如 果 不 需要 自动 扩容 roots， 可 以 使 用 下 面 的 方法 来 禁止 
a 首先 将 linux 镜像 伐 录 到 TF 卡 中 
b.， 然后 将 TF 卡 插 入 Ubuntu PC 中 〈(Windows 不 行 ) ，Ubuntu PC 一 般 会 自动 
挂 载 TF 卡 的 分 区 ， 如 果 自 动 挂 载 正常 ， 使 用 ls 命令 可 以 看 到 下 面 的 输出 ， 
TF 卡 的 分 区 名 和 下 面 命令 所 示 名 字 不 一 定 相 同 ， 请 根据 实际 情况 进行 修改 
testtest:~$ ls /media/test/27e62f92-82S0-4efl-83db-3d8f0c2e23db/ 


bin boot dev_ etc home lb lost+tfound media mnt opt proc root run 


Sbin selinux SrV SYS tmp usr Var 
c. 然后 在 Ubuntu PC 中 将 当前 用 户 切换 成 root 用 户 
testtest:~$ sudo -1 
[sudo] test 的 密码 : 
roottest:~# 
d.， 然后 进入 TF 卡 中 的 linux 系统 的 root 目录 下 新 建 一 个 名 为 .no_rootfs_resize 
的 文件 
roottest:~##cd /media/test/27e62f92-82S0-4efl1-83db-3d8f0c2e23db 
roottest:/media/testV27e602f92-8250-4efl-83db-3d8f0oc2e23db# cd root 
roottest:/media/testU27e62f92-8230-4efl-83db-3d8foc2e23db/roo 协 touch .no_rootfs_resize 
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roottest:/media/ltest27e602f92-8250-4efl-83db-3d8f0c2e23db/roo 坪 ls .no_rootfs* 


.n0O_Tootfs reslize 
e.， 然后 就 可 以 外 载 TF 卡 ， 再 拔 出 TF 插 到 开发 板 启动 ，linux 系统 启动 时 ， 当 
检测 到 /mioot 目录 下 有 .no_rootfs resize 这 个 文件 就 不 会 再 自动 扩容 rootfs 了 
f 禁止 rootfs 自动 扩容 后 可 以 看 到 TF 卡 可 用 容量 只 有 200M 左右 


root(Oorangepi:~#df -h 

Filesystem Size Used Avail Use% Mounted on 

udev 927M 0 927M ”09% /dev 

tmpf 200M 3S.OM 194M 39% mun 
dev/mmcblk0pl 1.SG 1.3G 1906M 872o / 

[tmp 如 997M 0 997M ”0% /dev/shm 
tmpf S.0OM 4.0O0K 5S.OM 19%o umlock 
tmpfs 997M 0 997M 09% /Sys/fsS/cgroup 
tmpf 997M 4.0KE 997M 1% /tmp 
dev/zram0 49M 15SM 44M 4% /varvlog 
tmpfA 200M 0 200M 0% mun/user0 


3.7.， 修改 linux 日 志 级 别 〈loglevel) 的 方法 


1) linux 系统 的 loglevel 默认 设置 为 1， 当 使 用 串口 查看 启动 信息 时 ， 内 核 输出 log 
如 下 所 示 ， 基 本 全 部 屏蔽 了 
Starting kernel .… 


[Uncompressing Linux.… done, booting the kernel. 


Orange Pi 2.1.0 Focal ttyS0 


orangepi login: 


2) 当 1linux 系统 局 动 出 现 问题 时 ， 可 以 使 用 下 面 的 方法 来 修改 loglevel 的 值 ， 从 而 
打印 更 多 的 log 信息 到 串口 显示 ， 方 便 调 试 。 如 果 linux 系统 启动 失败 ， 无 法 进入 系 
统 ， 可 以 把 TF 卡通 过 读 卡 器 插入 Ubuntu PC 中 ， 然 后 在 Ubuntu PC 中 挂 载 TF 卡 后 
直接 修改 TF 卡 中 的 linux 系统 的 配置 ， 修 改 完 后 ， 再 把 TF 卡 插入 开发 板 中 局 动 
rootOorangepi:~#sed -i "S/verbosity=1/verbosity=7/" /bootorangepiEnv.txt 
rootOorangepi:~#sed -i"s/console=both/console=serial/"” /boot/orangepiEnv.txt 
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3) 上 面 的 命令 其 实 都 是 设置 /bootborangepiEnv.txt 中 的 变量 ， 设 置 完 后 可 以 打开 
/bootorangepiEnv.txt 检查 下 
rootOorangepi:~#cat /bootorangepiEnv.txt 


[verbosity=7 


console=serial 


4) 然后 重 局 开发 板 ， 内 核 的 输出 信息 就 都 会 打印 到 串口 输出 了 


3. 8. 以 太 网 口 测试 


1) 首先 将 网 线 插入 开发 板 的 以 太 网 接口 ， 并 确保 网 络 是 畅通 的 


2) 系统 局 动 后 会 通过 DHCP 自动 给 以 太 网 卡 分 配 卫 地 址 


3) 查看 卫 地 址 的 命令 如 下 

rootOorangepi:~#ifconfig eth0 

eth0: flags=4163<UPBROADCASTRUNNING,MULTICAST> mtu 1500 
inet 192.168.1.47 netmask 233.235$.233.0 “broadcast 192.168.1.25335 
inet0 fe80::e96:c34d:62f0:8d6e prefixlen 64 scopeid 0x20<link> 
ether 02:81:3e:a8:38:d8 ”txqueuelen 1000 (Etherneb 
RX packets 2163 bytes 177198 (177.1 KB) 
RX errors 0 dropped 0 overruns 0 _ frame 0 
TX packets 312 bytes 40435 (40.4 下 B) 


TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 


device interrupt 39 


4) 测试 网 络 连通 性 的 命令 如 下 

rootOorangepi:~#ping www.baidu.com -Ieth0 

PING www.a.sShifen.com (14.213.177.38) from 192.168.1.12 eth0: 96(84) bytes of data. 
64 bytes from 14.213.177.38 (14.213.177.38): icmp sedq=]l tt=S6 time=0.74 mas 

64 bytes from 14.215.177.38 (14.213.177.38): icmp_ seq=2 t=56 time=0.80 ms 

64 bytes from 14.215.177.38 (14.213.177.38): icmp seq=3 tl=56 time=0.260 ms 

64 bytes from 14.213.177.38 (14.213.177.38): icmp sedq=4 ttl=S6 time=7.27 mas 

八 人 
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--- WwWWwW.a.Shifen.com ping statistics --- 
4 packets transmitted, 4 recelived, 0% packet loss, ttme 3002ms 
rtt min/avg/max/mdev = 0.260/6.770/7.273/0.373 mas 


3. 9， SSH 远程 登录 开发 板 


Linux 系统 默认 都 开启 了 ssh 远程 登录 ， 并 且 人 允许 root 用 户 登 录 系 统 。ssh 登录 
前 首先 需要 确保 以 太 网 或 者 wifi 网 络 已 连接 ， 然 后 使 用 ionfig 命令 或 者 通过 查看 
路 由 器 的 方式 获取 开发 板 的 耳 地 址 


3.9.1.， Ubuntu 下 SSH 远程 登录 开发 板 
1) 获取 开发 板 的 耳 地 址 


2) 然后 就 可 以 通过 ssh 命令 远程 登录 linux 系统 
test@test~$ ssh root@192.168.1.36 (需要 蔡 换 为 开发 板 的 卫 地 址 ) 
root@192.168.1.36's password: 《在 这 里 输入 密码 ， 默 认 密 码 为 orangepi) 


3) 成 功 登 录 系 统 后 的 显示 如 下 图 所 示 


:~-$ ssh rootG192.168.1.36 
rootG192.168.1.36'Ss password : 


Bionic with 


0.04 0.02 Up time: 
of 967MB IP : 


of 156G 


Last Login: Tue 0ct 13 08:21:45 2020 from 192.168.1.48 


: -## 


4) ssh 登录 时 如 果 提 示 下 面 的 错误 
testtest:~$ ssh root@192.168.1.36 
Connection reset by 192.168.1.149 port 22 


lost connection 
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可 以 在 开发 板 上 输入 下 面 的 命令 再 党 试 是 否 能 连接 


root(Oorangepli:~##ITm /etc/ssh/ssh host *# 
rootOorangepi~ 坟 dpkg-reconfigure openssh-server 


3. 9. 2， “Windows 下 SSH 远程 登录 开发 板 
1) 首先 获取 开发 板 的 卫 地 址 


2) 在 windows 下 可 以 使 用 MobaXterm 远程 登录 开发 板 ， 首 先 新 建 一 个 ssh 
a 打开 Session 


然后 在 Session Setting 中 选择 SSH 
然后 在 Remote host 中 输入 开发 板 的 下 地 址 


b 
C 
d， 然 后 Specify username 中 输入 linux 系统 的 用 户 名 root 或 orangepi 
e.， 最 后 点 击 OK 即 可 


上 几 友 加 要 阅 旦 息 w 9@ 


2. 选择 SSH 


1. 打开 dession 
三 


3. 输入 开发 板 的 I|P 地 址 


4. 输入 linux 系 统 的 用 户 名 ，orangepi 或 root 


5. 最 后 点 击 OK 


2 


UWREGISTERED VERSIOW ，Pesoe scpotebenerm by wesabe 四 


3) 然后 会 提示 输入 密码 ， 默 认 root 和 orangepi 用 户 的 密码 都 为 orangepi 
辐 192.168.1.36 (roo) 
Terminal Sessions View Xserver Tools Games Settings Macros Help 

园 六 并 本 紊 国 国 阅 由 区 @ 
Session 。” Servers Tools Games ”Sessions View Splt MultiExec Tunneling Packages ”Settings Help 


DuUick connect.. 全 2. 192.168.1.36 (root) 


《| 闫 uer=sor | 园 -oote 's password: 


名 192.16s.1.36 koob 


ssions 
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会 话 


女 e 


4) 成 功 登 录 系 统 后 的 显示 如 下 图 所 示 


醒 192.168.1.36 (roo 


Terminal Sessions View Xserver Tools Games Settings Macros Help 


国 六 并 有 妈 国 国 半 鱼 息 区 @ 


Session ”Servers Tools Games ”Sessions View Splt MultiExec Tunneling Pacdkages Settings Help 


[ oot 

号 

四 | 一 Nam 

员 

昌 轿 .. 

,cadhe 

宽 本 .ant 

血  .gnupg 

各 

,bash_hist 

如 ，ctrlL+cLick on heLp or visit our 
作 ,bashrc 

,desktop_autologi 

多 

.profile 

8 .viminfo 

三 

者 

折 

加 
图 Blonlc with 


9.19 0.65 Up tlme: 
of 967MB 了 PP: 


of 156 
: orangepi-config ] 


Tue 0ct 13 98:15:39 2929 from 


rootG@orangepI:~# 国 


3. 10. HDMI 显示 测试 


1) 使 用 HDMI 转 HDMI 线 连接 Orange Pi 开发 板 和 HDMI 显示 器 


四 


2) 启动 lnux 系统 后 如 果 HDMI 显示 器 有 图 像 输 出 说 明 HDMI 接口 使 用 正常 


3. 11. Linux4.9 系统 HDMI 分 辨 率 设 置 


注意 : 此 方法 只 适用 于 linux4.9 内 核 的 系统 ，linuxS.4 内 核 的 系统 无 法 使 用 


1D) 在 1linux4.9 系统 的 /booVorangepiEnv.txt 中 有 个 disp_ mode 变量 ， 可 以 通过 它 来 设 
置 HDMI 输出 的 分 辩 率 ，linux 系统 默认 设置 的 分 辩 率 为 1080p60 
root(Oorangepi:/boo 姑 cat orangepiEnv.txt 

verbosity=1 

disp_ mode=1080p00 
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2) disp_ mode 变量 支持 设置 的 值 如 下 表 所 示 


disp_ mode 支持 的 值 HDMI 分 辩 率 HDMI 刷新 率 
480i 720x480 60 
S76i 720x480 S0 
480p 720x480 60 
S76p 720xS76 60 

720pSs0 1280x720 S0 
720p60 1280x720 60 
1080iS0 1920x1080 S0 
1080i60 1920x1080 60 
1080p24 1920x1080 24 
1080pS0 1920x1080 S0 
1080p60 1920x1080 60 
2160p24 3840x2160 24 
2160p25 3840x2160 25 
2160p30 3840x2160 30 


3) 将 disp_mode 变量 的 值 修改 为 想 要 输出 的 分 辩 率 ， 然 后 重启 系统 ，HDMI 就 会 输 
出 所 设置 的 分 辨 率 了 


4) 如 果 设 置 了 HDMI 的 输出 分 辩 率 为 2160p24、2160p25 或 者 2160p30，HDMI 需 
要 接 到 支持 4K 显示 的 电视 或 者 显示 器 才能 正常 显示 
a. 接 到 4K 电视 显示 如 下 所 示 


和 3840X2160 
一 HDMI1 30Hz 


rr 


b. 如 果 接 到 不 支持 4K 显示 的 电视 或 者 显示 器 ， 会 无 法 显示 ， 如 下 图 所 示 接 到 
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1080p 的 电视 直接 显示 不 支持 格式 


5) 查看 HDMI 驱动 输出 分 辩 率 的 方法 如 下 所 示 《〈 下 图 显示 的 HMDI 输出 的 分 辨 率 
为 2160p25) ， 如 果 显 示 的 分 辨 率 和 设置 的 分 辩 率 一 样 ， 说 明 开 发 板 这 端的 设置 正 
全 
rootOorangepi:~#cat /Sys/class/disp/disp/attr/Sys 


芋 


# Cat SyS 
Screen 0: 
e_rate 696060006 hz，ref fps:25 
站 3840x2169 fmt[rgb] cs[9x9] range[Limit] eotf[9x9] bits[8bits] err[9] force sync[9] unbtLank direct show[fatse] 


3846x2160 


VSync:90 VSync_Sskijl 
nabtLe ch[1] Lyr[9] z[9] prem[N] a[gLobL 255] fm 汪 9] fb[1929,1989;1929,1980;1920,1980] crop[ 987 9,1920,1989] frame[ 9， 9,3840,2166] addr[fe909009， 
站 有 seX 9] trd[9,9] 
本 96] transf[9] 


3. 12. Linux4.9 系统 Framebuffer 宽度 和 高 度 的 修改 方法 


注意 : 此 方法 只 适用 于 linux4.9 内 核 的 系统 ，linuxs.4 内 核 的 系统 无 法 使 用 


linux 系统 的 /bootorangepiEnv.txt 中 有 fb0_width 和 fbp0_height 两 个 变量 ,可 以 
它们 来 设置 Framebuffer 的 宽度 和 高 度 ，linux 系统 默认 设置 fbp0_ width=1280、 

ee 

rootOorangepi:~#cat /bootorangepiEnv.txt 


verbosity=1 
console=both 

disp mode=1080p60 
fb0_width=1280 
fb0_height=720 
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2) fb0_width 和 fb0_height 不 同 分 辩 率 对 应 的 参考 值 如 下 所 示 


HDMI 分 辩 率 fb0_ width fb0_height 
480p 720 480 
S76p 720 576 
720p 1280 720 

1080p 1920 1080 
2100p 1920 1080 


3) 在 相同 的 HDMI 分 辨 下 ， 不 同 的 fb0_ width 和 fb0_height 的 显示 情况 如 下 所 示 ， 
当 fb0_ width 和 fb0_height 设置 的 值 越 大 时 ， 屏 幕 显示 的 文字 就 越 小 ， 当 fb0_width 


和 fb0_height 设置 的 值 越 小 时 ， 屏 幕 显 示 的 文字 就 越 大 


3. 


HDMI 分 辨 率 为 1080p60, fb0_width 和 fb0_height 为 1920x1080 的 显示 情况 


b，、HDMI 分 辨 率 为 1080p60，fb0_ width 和 fp0_height 为 1280x720 的 显示 情况 
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本 


Beachea target Netuork (Pre) 

ES Load Kernel Modules . 

Starting Remount Root and Kernel File Systems.. 
Starting udeu Coldplug all Deuices... 

Mounted POSIX Message Queue File System. 
Mounted Kernel Debug File Susten. 

Mounted Kernel Trace File Systemn- 

Finished Create list of static deuice nodes for the current kermel ， 
Finished Load Kernel Module drn. 

Finished Renount Root and Kernel File Systems- 
Finished Restore / saue the current clock. 
Finished Load Kernel Modules . 

Mounting FUSE Control File Systemn... 

Mount ing Kernel Configuration File Systen... 
Starting Load/Saue Random Seed. 

Starting hpply Kernel Uariables 

Starting Create System Users... 

Mounted FUSE Control Pile Systemn. 

Mounted Kernel Configuration File Systen. 
Finished Load/Saue Randomn Seed . 

Finished Create System Users . 

Starting Create Static Deuice Nodes in vdeu... 
Finisheda Set the console keyboard layout. 
Finished hpply Kernel Uariables 

Finished Create Static Deuice Modes in jaeu. 
Reached target Local File Systems (Pre) 
Mounting tmp.. . 

Starting udeu Kernel Deulce Hanager... 

Finished udeu Coldplug all Deuices. 

Hounteda tmp. 

Reached target Local File Systemns . 

Starting Set console font and keynap... 
Starting Helper to synchronize boot up for tfupdown... 
Starting 0range Pi ZRhRM config... 

Finished Set console font and kegnwap 

Finished HeIper to synchronize boot up for ifupdown， 
Starting Raftse netwuork interfaces... 

Started udeu Kernel Deuice Hanager . 

Flnished Ratse network interfaces . 


c， HDMI 分 辨 率 为 1080p60，fb0_ width 和 fb0_height 为 720x576 的 显示 情况 


全 .的 .的 所 


F imisheda Create 1ist of static deuice nodes for the cuoreent kernel. 
Fimished Load Kernel Modaule dcrnm . 

F inished Load Kernel Modules . 

Moumnt ing FUSE Control File Sustem... 

Mount ing Kernel Configuration File Sustem 
Starting 9pplu Kernel Uariables. . 
Fimisheda Restore saue the cuorent clock . 
Finisheda Remoumt Root and Kernel File SuUstems . 
Moumteda FUSE Control File Sustem . 

Moumnted Kernel Conf iguoration File SuUstenm - 

F inmisheda hpplu Kernel Uariables - 

Starting Load~Sauwe Random Seed . 

Starting Create SUustem Users- - 

Finished Load~Saue Random Seeda . 

Finisheda Create Sustem Users-. 

Starting Create Static Deuice Nodes in “dew.-.-- 
Fimnmished Set the console keuboard lauUout - 

Finished Create Static Deuice Nodes in “deu. 

Reached target Local File Sustems (Pree). 

Moumting mp . 

Starting udeuw Kernel Deuice Manager... 

Finished udeuw Coldplug all Deuices . 

Moumted mp - 

Reacheda target Local File Sustems . 

Starting Set console font and keUumap..- 

Starting Helper to suUunchronize boot up for ifupdaouwn..- 
Starting Deange Pi ZRAM config. . . 

Finisheda Set console font amnd keuUumap . 

Finisheda Helper to sunchronize boot up for ifupdownmn 
Stating Raise network interfaces-.-- 


d，HDMI 分 辨 率 为 1080p60，fb0_ width 和 fb0_height 为 720x480 的 显示 情况 
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人 4 


Starting Create SUstem Users... 
F inished Restore ”saue the curent clock . 

] Moumted FUSE Control File SUstenm . 
Moumted kernel Conf iguration File Sustem. 
F inmished LoadSaue Random Seed . 
F imisheda hppblu Kernel Uariables . 
Finished Create SUstem Users . 
Starting Create Static Deuice Nodes in deu... 
Finished Set the console keuboard lauout . 
Finished Create Static Deuice Nodes in “deu. 
Reached target Local File SuUstems (Pre). 
Moumting tmp.. . 
Starting udeu Kernel Deuice Manager ... 
Finished udeuw Coldplug all Deuices . 
Moumted -tmp . 
Reached target Local File SUStems . 
Starting Set console font and keuUmap... 
Starting Helper to suUunchronize boot up for ifupdowum... 
Starting Drange Pi ZRhAM config..， 
Finished Set console font and keUumap . 
Finished Helper to suUnchronize boot up for ifupdown . 
Starting Raise metwork interfaces..， 
Started udeu Kernel Deuice Mamnagenr . 
Finished Raise metwork inmterfaces . 


3. 13. Framebuffer 光标 相关 的 设置 


1) Framebuffer 使 用 的 softecursor， 设 置 光标 闪烁 或 者 不 内 烁 的 方法 如 下 所 示 
root@orangepi:~#echo 1 > /sys/class/graphics/fbcon/cursor blink 。 # 沦 标 闪 烁 
root@orangepi:~#echo 0 > /sys/class/graphics/fbcon/cursor blink 。 ## 沦 标 不 闪烁 


2) 如 果 需 要 隐藏 光标 ， 可 以 在 /bootorangepiEnv.txt 的 extraargs 变量 〈extraargs 
的 值 会 赋值 给 bootargs 环境 变量 最 终 传 递 给 内 核 ) 中 加 人 入 
vtglobal cursor default=0 (如 果 wglobal cursor default=l 则 是 显示 光标 ) ， 然 
后 重启 系统 就 能 看 到 光标 已 经 消失 


root(Oorangepi:~ 和 ## cat /boot/orangepiEnv.txt 


verbosity=1 

console=both 

disp mode=1080p60 

fb0_ width=1280 

fb0_height=720 

extraargs=cma=23M vtglobal _ cursor _ default=0 
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3. 14. 香 橙 派 5 寸 TFT 液晶 屏 测试 
注意 ， 此 方法 只 适用 于 linux4.9 内 核 的 系统 ，linuxs.4 内 核 的 系统 无 法 使 用 
1D) 首先 准备 好 香 栖 派 的 5 寸 TFT 液晶 屏 ， 屏 幕 排 线 和 转 接 板 的 接线 方式 如 下 图 所 


示 ， 请 勿 接 反 了 ， 另 外 请 确保 屏幕 排 线 和 排 线 插座 接触 都 到 位 了 ， 如 果 接 触 不 到 位 ， 
屏幕 输出 会 有 问题 


香 橙 泊 


需要 单独 供电 ， 请 在 转 接 板 的 Micro USB 接口 中 插入 5V/2A 的 电源 


NANNRN NAN 
并 N SN SN 


3) 在 /bootorangepiEnv.txt 中 修改 HDMI 输出 分 辨 率 为 480p，Framebuffer 的 长 度 和 
宽度 可 以 设置 为 800x480， 如 果 设 置 为 1280x720，TEFT 液晶 屏 显示 的 字体 会 很 小 
root(Oorangepi:~ 和 cat /boot/orangepiEnv.txt 


disp mode=480p 
fb0_width=800 
fb0_height=480 
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4) 开发 板 启 动 后 ， 屏 幕 就 可 以 看 到 启动 画面 了 


5) 关闭 开发 板 的 电源 后 ， 请 记得 同时 关闭 屏幕 转 接 板 的 电源 ， 下 次 启动 开发 板 时 再 
打开 


3. 15， WIFI 连接 测试 


请 不 要 通过 修改 /ete/mnetworkyinterfaces 配置 文件 的 方式 来 连接 WIFI， 通 过 这 种 
方式 连接 WIFI 网 络 使 用 会 有 问题 


3. 15. 1. ”服务 器 版 镜像 通过 命令 连接 WIFI 

当 开 发 板 没有 连接 以 太 网 ， 没 有 连接 HDMI 显示 屏 ， 只 连接 了 串口 时 ， 推 荐 使 
用 此 小 节 演 示 的 命令 来 连接 WIFI 网 络 。 因 为 nmtui 在 某 些 串口 软件 〈 如 minicom ) 
中 只 能 显示 字符 ， 无 法 正常 显示 图 形 界面 。 当 然 ， 如 果 开 发 板 连 接 了 以 太 网 或 者 
HDMI 显示 屏 ， 也 可 以 使 用 此 小 节 演 示 的 命令 来 连接 WIFI 网 络 的 


1) 先 登 录 linux 系统 ， 有 下 面 三 种 方式 
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a 如 果 开 发 板 连接 了 网 线 ， 可 以 通过 ssh 远程 登录 linux 系统 

a. 如 果 开 发 板 连 接 好 了 调试 串口 ， 可 以 使 用 串口 终端 登录 linux 系统 
如 果 连 接 了 开发 板 到 HDMI 显 示 器 , 可 以 通过 HDMI 显 示 的 终端 登录 到 linux 
系统 


2) 首先 使 用 namecli dev w 返 命令 扫描 周围 的 WIFI 热点 


root(Oorangepi:~##mnmcli dev w 让 


:-# nmcLi dev wifi 
IN-USE  BSSID SSID MODE CHAN RATE SIGNAL BARS ”SECURITY 


3) 然后 使 用 nmeli 命令 连接 扫描 到 的 WIFI 热点 ， 其 中 : 

a. wifi name 需要 换 成 想 连 接 的 WIFI 热点 的 名 字 

b.， wifi_passwd 需要 换 成 想 连 接 的 WIFI 热点 的 密码 
rootOorangepi~##nmcli dev w 这 connect w 记 name password WwW 这 passwd 
IDevice "wlan0' successfully activated with "cf937f8-cale-4411-bbS0-61f402eef293 


4) 通过 ifconfig 命令 可 以 查看 w 厦 的 卫 地 址 

root(Oorangepi:~##ifconfig wlan0 

Iwlan0: flags=4103<UPBROADCASTRUNNING,MULTIICAST> mtu 1300 
inet 192.168.1.49 netmask 235$.233$.233.0 “broadcast 192.168.1.253 
inet0 fe80::76bb:f67d:efo8:2foa prefixlen 64 scopeld 0x20<link> 
ether 12:81:3e:a8:98:d8 ”txqueuelen 1000 (Etherneb 
RX packets 18$ bytes 109447 (109.4 上 KB) 
RXerrors 0 dropped 61 overruns 0 frame 0 
TX packets 27 bytes 14783 (14.7 上 KB) 


TX errors 0 _ dropped 0 overruns 0 carrier 0 collisions 0 
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5$) 使 用 ping 命令 可 以 测试 wi 网 络 的 连通 性 
root(Oorangepi:~##ping www.baidu.com -I wlan0 
PING www.a.Shifen.com (14.213.177.39) from 192.168.1.119 wlan0: 3$6(84) bytes of 
data. 

64 bytes from 14.215.177.39 (14.213.177.39): icmp_ seq=3 tl=56 time=13.0 ms 
64 bytes from 14.215.177.39 (14.213.177.39): icmp_ seq=4 t=56 time=12.8 ms 
64 bytes from 14.215.177.39 (14.213.177.39): icmp_seq=S t=56 time=13.7 ms 
64 bytes from 14.215.177.39 (14.213.177.39): icmp_ seq=6 tl=56 time=14.9 ms 
64 bytes from 14.215.177.39 (14.213.177.39): icmp_ seq=7 t=56 time=13.0 ms 
从 全 


3. 15. 2. ”服务 器 版 镜像 通过 图 形 化 方式 连接 WIFI 


1) 先 登 录 linux 系统 ， 有 下 面 三 种 方式 
a 如 果 开 发 板 连 接 了 网 线 ， 可 以 通过 ssh 远程 登录 linux 系统 
b.， 如 果 开 发 板 连 接 好 了 调试 串口 ， 可 以 使 用 串口 终端 登录 linux 系统 〈 串 口 软 
件 请 使 用 MobaXterm， 使 用 minicom 无 法 显示 图 形 界 面 ) 
c. 如 果 开 发 板 连接 了 开发 板 到 HDMI 显示 器 ， 可 以 通过 HDMI 显示 的 终端 登 
录 到 linux 系统 


上 


2) 然后 在 命令 行 中 输入 nmtui 命令 打开 wifi 连接 的 界面 


root(Oorangepi:~ 坟 mnmtui 


3) 输入 nmtui 命 计 令 打 开 的 界面 如 下 所 示 


NetworkManager TUI 


PLease seLect an option 


Activate a connection 
Set system hostname 


Quit 


<0K> 
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4) 选择 Activate a conneet 后 回 车 


5) 然后 就 能 看 到 所 有 搜索 到 的 WIFI 热点 


rangepi 


6) 选择 想 要 连接 的 WIFI 


7) 然后 会 弹出 输入 密码 的 对 话 框 , 在 Pssword 内 输入 对 应 的 密码 然后 回 车 就 会 开始 
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连接 WIFI 


Wired 了 
# Wired connection 1 对 
失 


<Activate> 
Wi-Fi 器 
Authentication required by wireLess network 


Passwords or encryption keys are required to access the 


wiretess network ' orangepi'. 1 输入 WIFI 


下 


2. 按 下 回 车 键 


<CanceL> <0K> 
人 


8) WIFI 连接 成 功 后 会 在 已 连接 的 WIFI 名 称 前 显示 一 个 “#?” 


9) 通过 ifconfig 命令 可 以 查看 w 运 的 卫 地 址 

root(Oorangepi:~##ifconfig wlan0 

Iwlan0: flags=4103<UPBROADCASTRUNNING,MULTIICAST> mtu 1300 
inet 192.168.1.49 netmask 233.233.233.0 “broadcast 192.168.1.234 
inet6 fe80::76bb:f6o7d:efo8:2foa prefixlen 64 scopelid 0x20<link> 
ether 12:81:3e:a8:38:d8 ”txqueuelen 1000 (Etherneb 

RX packets 18$ bytes 109447 (109.4 上 KB) 

RX errors 0 dropped 61 overruns 0 frame 0 

TX packets 27 ”bytes 14783 (14.7 KB) 


TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 


10) 使 用 ping 命令 可 以 测试 w 庆 网 络 的 连通 性 


rootOorangepi~##ping www.baidu.com -I wlan0 


Www.orangepli.cn 49 Www.xXunlong.tv 


半 range Pi 用 户 手册 深圳 市 迅 龙 软 件 有 限 公 司 版 权 所 有 


PING www.a.Shifen.com (14.213.177.39) from 192.168.1.119 wlan0: 36(84) bytes of 
data. 

64 bytes from 14.215.177.39 (14.213.177.39): icmp_ seq=3 t=56 time=13.0 ms 
64 bytes from 14.215.177.39 (14.213.177.39): icmp_ seq=4 t=56 time=12.8 ms 
64 bytes from 14.215.177.39 (14.213.177.39): icmp_ seq=S t=56 time=13.7 ms 
64 bytes from 14.215.177.39 (14.213.177.39): icmp_ seq=6 t=56 time=14.9 ms 
64 bytes from 14.215.177.39 (14.213.177.39): icmp_ seq=7 t=56 time=13.0 ms 
Ae 


3. 15. 3. 桌面 版 镜像 的 测试 方法 
D 点 击 桌面 右上 角 的 网 络 配置 图 标 〈 测 试 WIEI 时 请 不 要 连接 网 线 ) 


2) 在 弹出 的 下 拉 框 中 点 击 More networks 可 以 看 到 所 有 扫描 到 的 WIFI 热点， 然后 
选择 想 要 连接 的 WIFI 热点 
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国有 1 


Ethernet Network 


由 sconnected 


Wi-Fi Networks 


Connect to Hidden Wi-Fi Network.…. 


V 叶 Create New Wi-Fi Network.… 
SN | 
共 / ] 2 VPN Connections 上 
EN ES 叶 [ 史 Enable Networking 


会 回 Enable wi-Fi 


Connection Information 


Edit Connections.… 


iorangepi_5G 


Wi-Fi Nerwork Authentication Required 
Authentication required by Wi-Fi network 


Passwords or encryption keys are required to access the Wi- 


Fi network 3 orangepi~- 


[J Show password 


4) 连接 好 WIFI 后 ， 可 以 打开 浏览 器 碍 看 是 否 能 上 网 ， 浏 览 器 的 入 口 如 下 图 所 示 
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避 Terminal Emulator 
File Manager 
加 Mail Reader 
合 Web Browser 
国 settings 

了 芝 Accessories 
用 Development 
.看 Graphics 
二 Internet 
硕 Multimedia 
蚁 offce 
号 System 
荔 Log Out 


[Chromium Web Browser 


如 时 本 有 可 避 时 时 


5) 打开 浏览 器 后 如 果 能 看 到 Orange Pi 网 站 的 页 面 ,或 者 能 打开 其 他 网 页 说 明 WIFI 
连接 正常 


四 sppicauons 
| 硬 omange Pi- orangepi x | 十 
和 > 人 @Notsecure|orangepiorg 六 四 : 
型 Apps 
全 sign In 
Fonge F Home “ News “Model “Resources “partners “ Forum Community English | 中 文 


omangepipc 作 - 本。 
@ 


www.orangepi.org 


New generation mini pc 


point meto buythe boards 


What's Orange Pi Pc Plus ? 


www -orangepiorg/orangepione 


3. 16. 蓝牙 使 用 方法 


3. 16. 1. 桌面 版 镜像 的 测试 方法 
1) 点 击 桌面 右上 角 的 蓝牙 图 标 
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加 10:20 灾 orangepi 


2) 然后 选择 适配器 
国 国 于 困 :…: 


岛 Turn Bluetooth off 
人 @ Make Discoverable 


书 三 种 |orangepi 


| 已 Setup New Device... 
二 Send Files to Device.… 


励 Browse Files on Device.…. 


Recent Connections.， 


目 Devices.… 


国 Local services.… 
喜 plugins 

寅 Help 

Exit 


3) 在 蓝牙 的 适配器 设置 界面 中 设置 Visibility Setting 为 Always visible， 然 后 点 击 
close 关闭 


Bluertooth Adapters 
orangepizero2 


Visibility Setting 
_) Hidden 


Always visible 


WU Temporarily visible 


Friendly Name 


orangepizero2 


Close 从 


4) 然后 打开 蓝牙 设备 的 配置 界面 
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和 妨 Turn Bluetooth ofF 


已 Setup New Device... 

> Send Files to Device... 
Browse Files on Device... 
da Recent Connecti 
Devices 
日 Adapters.… 
国 Local services.… 
四 plugins 

位 Help 

固 Ex 比 


5) 点 击 Search 即 可 开始 扫描 周围 的 蓝牙 设备 


Redmi K20 Pro Premium Edition 
W Smart phone 
国 | ”2o:r4:78:0D:63AC 


忆 orang 
园 Dec:72.9B 


内 530KB 0006sS12.61 KB 0.0085s 避 避 


6) 然后 选择 想 要 连接 的 蓝牙 设备 , 再 点 击 鼠 标 右键 就 会 弹出 对 此 蓝牙 设备 的 操作 界 
面 ， 选 择 Pair 即 可 开始 配对 ， 这 里 演示 的 是 和 Android 手机 配对 


Bluerootrh Devices 


Adapter Device View Help 


Connect To: 
是 Audio source 
宣 Network Access point 


园 Send a File.… 


Rename device,… 
@@ kemove.… 


72:9B:4C:FS:CF 


从 5.30 kB6 0.00 8sS12.61 K8 0.00 5s 电 辐 
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7) 配对 时 ， 宋 面 的 右上 角 会 弹出 配对 确认 框 ， 选择 Confirm 确认 即 可 ， 此 时 手机 上 
也 同样 需要 进行 确认 


10:27 国光 种 orangepi 


Bluetocth 

pairing request for 
orangepi1DC;72:96:4C:F4:CF) 

Confirm value for authentication: 79303 


au ee 


8) 和 手机 配对 完 后 ， 可 以 选择 已 配对 的 蓝牙 设备 ， 然 后 右键 选择 Send a File 即 可 
开始 给 手机 发 送 一 张 图 片 


9) 发 送 图 片 的 界面 如 下 所 示 
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orangepi 
rmart phone 
DC:72:98:4C:IF4ICF 


地 Bluerooth File Transfer 


水 sending files via Bluetooth 


To: orangepi 


File: /homey/orangepl.png 


3. 16. 2. 服务 器 版 镜像 的 使 用 方法 

1) linux 系统 启动 时 会 运行 了 6256-bluetooth.service 服务 来 初始 化 赣 牙 设备 ,进入 系 
统 后 可 以 通过 hciconfig 命令 来 查看 是 否 存在 蓝牙 的 设备 节点 ， 如 果 存 在 ， 说 明 蓝 牙 
初始 化 正常 


root(Oorangepi:~##hciconfig -a 
hci0: 。 Type: Primary Bus: UART 
BD Address: 10:11:12:13:14:1$ ACLMTU: 1021:8 SCO MTU: 240:3 
UPRUNNING 
RX bytes:046 acl:0 sco:0 events:37 errors:0 
TX bytes:2630 acl:0 sco:0 commands:37 errors:0 
Features: O0xbf 0x 侍 0x8d 0xfe 0xdb 0x3d 0Ox7b 0Oxc7 
Packet type: DM1 DM3 DMS DH1I DH3 DH5S HV1 HV2 HV3 
Link policy: 
Link mode: SLAVE ACCEPT 
Name: 'orangepi3' 
Class: 0x000000 
Service Classes: Unspecified 
Device Class: Miscellaneous， 
HCI Version: 9.0 (0x9) Revision: O0x400 
LMP Version: 9.0 (0x9) Subverslion: 0x400 
Manufacturer: Spreadtrum Communications Shanghai Ltd (492) 


2) 使 用 bluetoothctl 扫描 蓝牙 设备 
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rootOorangepi:~#bluetoothectl 

[INEW] Controller 10:11:12:13:14:13 orangepli3 [default] 
Agent registered 

[bluetooth]# power on # 使 能 控制 器 

Changing power on Succeeded 

[bluetooth]# discoverable on  。 ## 设 置 控制 器 为 可 被 发 现 的 
Changing discoverable on Succeeded 

[CHG] Controller 10:11:12:13:14:1S Discoverable: yes 
[bluetooth]# pairable on ”# 设 置 控 制 器 为 可 配对 的 
Changing pairable on Succeeded 

[bluetooth]# scan on # 开 始 扫描 周围 的 蓝牙 设备 
IDiscovery started 

[CHG] Controller 10:11:12:13:14:1S Discovering: yes 

[NEW] Device 76:60:79:29:B9:31 76-60-79-29-B9-31 

[NEW] Device 9C:2E:Al1:42:71:11 小 米 手机 

[INEYW] Device DC:72:9B:4C:F4:CFE orangepi 

[bluetooth]# Scan o 任 # 扫 描 到 想 连接 的 蓝牙 设备 后 就 可 以 关闭 扫描 了 ， 然 后 记 
下 蓝牙 设备 的 MAC 地 址 ， 这 里 测试 的 蓝牙 设备 为 Android 手机 ， 赣 牙 的 名 字 为 
orangepi， 对 应 的 MAC 地 址 为 DC:72:9B:4C:F4:CF 
Discovery Stopped 

[CHG] Controller 10:11:12:13:14:1S Discovering: no 
[CHGO] Device DC:72:9B:4C:F4:CF RSSI is nil 


3) 扫描 到 想 配对 的 设备 后 就 可 以 进行 配对 了 ， 配 对 需要 使 用 设备 的 MAC 地 址 
[bluetooth]# pair DC:72:9B:4C:F4:CF # 使 用 扫描 到 的 蓝牙 设备 的 MAC 地 址 进 
行 配 对 

Attempting to palir with DC:72:9B:4C:F4:CF 
[CHG] Device DC:72:9B:4C:F4:CF Connected: yes 
Request confirmation 

[leeblm[agent] Confirm passkey 764475 (yesmmo)j: yes“# 在 这 里 输入 yes， 在 手机 上 也 
需要 确认 

[CHG] Device DC:72:9B:4C:F4:CF Modalias: bluetooth:v010Fp107Ed1436 

[CHG] Device DC:72:9B:4C:F4:CF UUIDS: 0000046a-0000-1000-8000-00805f9b34fb 
[CHG] Device DC:72:9B:4C:F4:CF ServicesResolved: yes 

[CHG] Device DC:72:9B:4C:F4:CF Paired: yes 
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Pairing successful 。 # 提 示 配 对 成 功 
[CHG] Device DC:72:9B:4C:F4:CF ServicesResolved: no 
[CHG] Device DC:72:9B:4C:F4:CF Connected: no 


4) 配对 成 功 后 ， 手 机 蓝牙 界面 的 显示 如 下 所 示 
所 ”蓝牙 


设备 名 称 


接收 的 文件 


1 orangepizero2 ] 


5) 连接 蓝牙 设备 需要 安装 pulseaudio-module-bluetooth 软件 包 ， 然 后 再 启动 
pulseaudio 服务 


rootOorangepi:~##apt update 
rootOorangepi:~#apt -y install pulseaudio-module-bluetooth 


rootOorangepi:~#pulseaudio --start 


6) 连接 蓝牙 设备 的 方法 
rootOorangepi:~#bluetoothctl 


Agent registered 

[bluetooth]# paired-devices # 查 看 已 配对 的 蓝牙 设备 的 MAC 地 址 
Device DC:72:9B:4C:F4:CF orangepl 

[bluetooth]# connect DC:72:9B:4C:F4:CF 。” # 使 用 MAC 地 址 连接 蓝牙 设备 
Attempting to connect to DC:72:9B:4C:F4:CF 

[CHG] Device DC:72:9B:4C:F4:CF Connected: yes 

Connection Successful 

[CHG] Device DC:72:9B:4C:F4:CF ServicesResolved: yes 

[CHG] Controller 10:11:12:13:14:1S Discoverable: no 

[orangepi]# # 出 现 这 个 提示 符 说 明 连 接 成 功 
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7) 连接 完 蓝牙 设备 后 ，Android 手机 的 蓝牙 配置 界面 就 可 以 看 到 已 连接 用 于 通话 和 
媒体 的 音频 的 提示 
羽 蓝牙 
设备 名 称 orangepi 
接收 的 文件 
已 配对 的 设备 
写 


可 用 设备 


3. 17. 板 载 LED 灯 测 试 说 明 


深圳 市 迅 龙 软 作 


有 限 公司 版 权 所 有 


1) 开发 板 上 有 两 个 LED 灯 ， 一 个 黄 灯 ， 一 个 红 灯 ， 系 统 启动 时 LED 灯 默 认 显 示 情 
况 如 下 所 示 
黄 灯 红 向 
u-boot 启动 阶段 灭 亮 
内 核 启动 到 进入 系统 亮 灭 
GPIO 口 PL7 PL4 
2) 设置 黄 灯 亮 灭 和 闪烁 的 方法 如 下 所 示 
a 首先 进入 黄 灯 的 设置 目录 


rootOorangepi:~# cd /Sys/class/leds/orangepi\:yellowN:status 


b， 设置 黄 灯 熄灭 的 命令 如 下 
root(Oorangepi:/Sys/class/leds/orangepi:yellow:status# echo 0 > brightness 

c， 设置 黄 灯 常 亮 的 命令 如 下 
root(Oorangepi:/Sys/class/leds/orangepi:yellow:status# echo 1 > brightness 

d， 设置 黄 灯 闪烁 的 命令 如 下 
root(Oorangepi:/Sys/class/leds/orangepi:yellow:status# echo heartbeat > trigger 

e.， 设置 黄 灯 停 止 内 烁 的 命令 如 下 


root(Oorangepi:/Sys/class/leds/orangepi:yellow:status# echo none > trigger 


3) 设置 红 灯 亮 灭 和 闪烁 的 方法 如 下 所 示 
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a. 首先 进入 红 灯 的 设置 目录 


root(Oorangepi:~# cd /Sys/class/leds/orangepi\:red:status 


b， 设置 红 灯 烛 灭 的 命令 如 下 


root(Oorangepi:/Sys/class/leds/orangepi:red:status# echo 0 > brightness 


c， 设置 红 灯 常 亮 的 命令 如 下 


root(Oorangepi:/Sys/class/leds/orangepi:red:status# echo 革 > brightness 


d， 设置 红 灯 内 烁 的 命令 如 下 


root(Oorangepi:/Sys/class/leds/orangepi:red:status# echo heartbeat > trigger 


e.， 设置 红 灯 停 止 闪烁 的 命令 如 下 


root(Oorangepi:/Sys/class/leds/orangepi:red:status# echo none > trigger 


3. 18. USB 接口 测试 


3. 18. 1. 连接 鼠标 或 键盘 测试 


D) 将 USB 接口 的 键盘 插入 Orange Pi 开发 板 的 USB 接口 中 


2) 连接 Orange Pi 开发 板 到 HDMI 显示 器 


3) 如 果 鼠 标 或 键盘 能 正常 操作 系统 说 明 USB 接口 使 用 正常 《鼠标 只 有 在 桌面 版 的 


系统 中 才能 使 用 ) 


3. 18. 2. 连接 UsB 存储 设备 测试 
1) 首先 将 U 盘 插入 Orange Pi 开发 板 的 USB 接口 中 


2) 执行 下 面 的 命令 如 果 能 看 到 sdX 的 输出 说 明 U 盘 识别 成 功 


root(@Oorangepi:~#cat /proc/partitions | Srep "Sdq*" 
major minor 邦 locks name 

8 0 30044160 sda 

8 1 ， 30043119 sdal 


3) 使 用 mount 命令 可 以 将 U 盘 挂 载 到 /mnt 中 ， 然 后 就 能 查 


看 U 盘 中 的 文件 了 


rootorangepi:~# mount /dev/sdal /mnt/ 


rootOorangepi:~#]s /mnt/ 
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test.txt 


4) 挂 载 完 后 通过 df -h 命令 就 能 查看 U 盘 的 容量 使 用 情况 和 挂 载 点 
rootOorangepi:~#df -h | grep "sd" 
dev/sdal 29G 208K 29G 1% /mnt 


3. 19. USB 无 线 网 卡 测试 


注意 : 此 方法 只 适用 于 linuxS.4 内 核 的 系统 ，linux4.9 内 核 的 系统 没有 调试 


linux5.4 系统 目前 测试 过 的 能 用 的 USB 无 线 网 卡 如 下 所 示 , 其 他 型 号 的 USB 无 线 网 
卡 请 自行 测试 ， 如 果 无 法 使 用 就 需要 移植 对 应 的 USB 无 线 网 卡 驱 动 


瑚 本 型 号 
RIL8723BU 
色 RIL8821CU 


3. 19. 1. 1，”RTL8723BU 测试 


1) 首先 将 RIL8723BU 无 线 网 卡 模块 插入 开发 板 的 USB 接口 中 


2) 然后 linux 系统 会 自动 加 载 RTL8723BU 相关 的 内 核 模 块 ， 通 过 lsmod 命令 可 以 
看 到 下 面 输出 

rootOorangepi:~#]lsmod | grep "rtl87 

rtl8XXXU 118784 0 

mac80211 S03808 1] rtl8xxxu 


3) 通过 dmesg 命令 可 以 看 到 RITL8723BU 模块 的 加 载 信息 
root(Oorangepi:~##dmesg | tail 

[ 1$83.90835S4] usb 3-1.1: le0: 任 任 任 任 在任 任 任 

[ 1$83.90835S7] usb 3-1.1: le8: 任 任 任 任 在任 任 任 

[ 1$83.908360] usb 3-1.1: 1f: 任 任 任 任 华人 在 人 在 企 

[ 1$83.908363] usb 3-1.1: 1 代 : 任 任 华人 在 任 企 人 在 企 

[ 1$83.908369] usb 3-1.1: RIL8723BU rev E (SMIC) 1TIR，TX queues 3，WiEFI=1| 
BT=1, GPS=0, HI PA=0 
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[1983.908373] usb 3-1.1: RIL8723BU MAC: 00:13:ef 伍 :98:ae 

[ 1383.908377] usb 3-1.1: rtl8xxxu: Loading firmware rtlwifiyrtl8723bu nic.bin 
[ 1S83.908336] usb 3-1.1: Firmware revlislion 33.0 (Signature 0xS301) 

[ 1984.013655] Bluetooth: hcil: RIL: fw version 0xle4cc3 住 

[ 1384.813324] rtl8xxxu 3-1.1:1.2 wlx0013efft4S8ae: renamed from wlan1l 


4) 然后 通过 ifconfig 命令 可 以 看 到 RTL8723BU WIFI 的 设备 节点 , WIFI 的 连接 和 测 
试 方法 请 参看 WIFI 连接 测试 一 节 ， 这 里 不 再 更 述 
rootOorangepi:~#jifconfig wlx0013eff4S8ae 
Iwlx0013efft4s8ae: flags=4099<UPBROADCASTMULIICAST> mtu 1300 
ether 00:13:ef 伍 :938:ae 区 queuelen 1000 (Etherneb 
RX packets 0 bytes 0 (0.0 B) 
RX errors 0 dropped 0 overruns 0 frame 0 
TX packets 0 bytes 0 (0.0 B) 
TX errors 0 _ dropped 0 overruns 0 carrier 0 collisions 0 


$) 然后 通过 hciconfig 命令 可 以 看 到 两 个 蓝牙 设备 ， 其 中 Bus 类 型 为 USB 的 节点 吏 
是 RIL8723BU 的 蓝牙 节点 ， 蔓 牙 的 测试 方法 请 参看 监 牙 使 用 方法 一 节 ， 这 里 不 再 
效 述 

root(Oorangepi:~#hciconfig 

hcil: Type: Primary Bus: USB 

BD Address: 00:13:EF:F4:38:AE ACLMTU: 1021:8 SCO MTU: 235:16 
UPRUNNING PSCAN ISCAN 

RX bytes:3994 acl:0 sco:0 events:206 errors:0 

TX bytes:29459 acl:0 sco:0 commands:173 errors:0 


hci0: Type: Primary Bus: UART 
BD Address: 10:11:12:13:14:1$9 ACLMTU: 1021:8 SCO MTU: 240:3 
UPRUNNING 
RX bytes:2981 acl:0 sco:0 events:127 errors:0 
TX bytes:9423 acl:0 sco:0 commands:61 errors:0 
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3. 19. 1. 2，”RTL8821CU 测试 


1) 首先 将 RIL8821CU 无 线 网 卡 模块 插入 开发 板 的 USB 接口 中 


2) 然后 linux 系统 会 自动 加 载 RITL8821CU 相关 的 内 核 模 块 ， 通 过 lsmod 命令 可 以 
看 到 下 面 和 输出 

rootOorangepi:~#lsmod | grep "88217 

8821cu 1941504 0 

cfg80211 336332 3 8821cu,brcmfmac,mac80211 


3) 通过 dmesg 命令 可 以 看 到 RTL8821CU 模块 的 加 载 信息 
rootOorangepi:~# dmesg | tail 

[ 1833.290228] usb 3-1.1: Product: 802.11ac NIC 
[1833.290239] usb 3-1.1: Manufacturer: Realtek 
[1833.290249] usb 3-1.1: SerialNumber: 1234536 

[ 18335.3717953] Bluetooth: hcil: RIL: examining hcli ver=08 hcl rev=000c lmp_ ver=08 
lmp_ subver=8821 

[ 18335.372733] Bluetooth: hcil: RIL: rom_ version status=0 verslion=1 

[ 1833.372771] Bluetooth: hcil: RIL: loading rtl btrtl8821c _ fw.bin 

[ 1833.373136] Bluetooth: hcil: RIL: loading rtl_ btrtl8821c config.bin 

[ 1833.373349] Bluetooth: pcil: RIL: cfg sz 10, total sz 21678 

[ 1833.784650] Bluetooth: hcil: RIL: fw version 0x820ca99e 

[ 1833.816409] rtl8821cu 3-1.1:1.2 wlxd0cObf742cd: renamed from wlanl 


4) 然后 通过 i 达 onfig 命令 可 以 看 到 RIL8821CU WIFI 的 设备 节点 , WIFI 的 连接 和 测 
试 方法 请 参看 WIFI 连接 测试 一 节 ， 这 里 不 再 殉 述 
root(Oorangepi:~#jfconfig wlxd0c0bftg742cdq 
Iwlxd0c0bfg742cd: flags=4099<UPBROADCASTMULIICAST> mtu 1500 
ether d0:c0:bf87:42:cd txqueuelen 1000 (Ethernet) 
RX packets 0 bytes 0 (0.0 B) 
RX errors 0 dropped 0 overruns 0 _ frame 0 
TX packets 0 bytes 0 (0.0 B) 


TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 


5$) 然后 通过 hciconfig 命令 可 以 看 到 两 个 蓝牙 设备 ， 其 中 Bus 类 型 为 USB 的 节点 就 
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是 RIL8821CU 的 蓝牙 节点 ， 蓝 牙 的 测试 方法 请 参看 蓝牙 使 用 方法 一 节 ， 这 里 不 再 
效 述 
rootorangepi:~#hciconfig 


hcil: Type: Primary Bus: USB 
BD Address: D0:C0:BF:87:42:CE ACLMTIU: 1021:8 SCO MTU: 235:12 
UPRUNNING 
RX bytes:1343 acl:0 sco:0 events:137 errors:0 
TX bytes:24227 acl:0 sco:0 commands:137 errors:0 


hci0: 。 Type: Primary Bus: UART 
BD Address: 43:45:C5:00:1F:AC ACLMTITU: 1021:8 SCO MTU: 64:1 
UPRUNNING 
RX bytes:1941 acl:0 sco:0 events:66 errors:0 
TX bytes:2816 acl:0 sco:0 commands:66 errors:0 


3. 20. USB 网 卡 测试 


1) 目前 测试 过 能 用 的 USB 网 卡 如 下 所 示 


序 呈 型 号 
RTL815S2B USB 百 兆 网 卡 
2 RTL8153 USB 千 兆 网 卡 


2) 首先 将 USB 网 卡 插入 开发 板 的 USB 接口 中 ， 然 后 在 USB 网 卡 中 播 入 网 线 ， 确 
保 网 线 能 正常 上 网 ， 如 果 通 过 dmesg 命令 可 以 看 到 下 面 的 log 信息， 说 明 USB 网 卡 
识别 正 第 
rootOorangepi:~# dmesg | taijl 

[ 121.989016] usb 3-1: USB disconnect, device number 2 

[ 126.873772] sunxi-ehcli S311000.ehcli3-controller: ehci irq: highspeed device connect 
[ 127.094034] usb 3-1: new high-speed USB device number 3 using Sunxi-ehci 

[ 127.357472] usb 3-1: reset high-speed USB device number 3 using Sunxi-ehci 

[ 127.$57960]r8152 3-1:1.0 eth1: v1.08.9 
[ 
[ 
[ 
[ 


HH 


127.60020642]Tr8132 3-1:1.0 enx00e04c362017: renamed from eth1 

127.731874] IPv6: ADDRCONF(INETDEV_UP): enx00e04c362017: lnk is not Teady 
127.763031] IPv6: ADDRCONF(INEITDEVY _UP): enx00e04c362017: lnk is not ready 
129.892463]T8132 3-1:1.0 enx00e04c362017: carrier on 
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[ 129.892583] IPv6: ADDRCONF(INETDEV_CHANGE): enx00e04c362017: link 


becomes ready 


3) 然后 通过 这 onfig 命令 可 以 看 到 USB 网 卡 的 设备 节点 ， 以 及 自动 分 配 的 耳 地 址 


rootOorangepi:~#ifconfig 
enx00e04c362017: flags=4163<UPBROADCASTRUNNING,MULTICAST> 
1500 
inet 192.168.1.177 netmask 253.25$3.233.0 broadcast 192.1608.1.235 
inet0 fe80::681 人 fd293:4bc9:e9fd prefixlen 64 scopeld 0x20<link> 
ether 00:e0:4c:36:20:17 txqueuelen 1000 (Etherneb 
RX packets 1849 bytes 134590 (134.3 KB) 
RX errors 0 dropped 123 overruns 0 _ frame 0 
TX packets 33 bytes 2834 (2.8 下 B) 


TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 


Imtu 


4) 测试 网 络 连通 性 的 命令 如 下 


rootOorangepi:~##ping www.baidu.com -Ienx00e04c362017 


PING www.a.sShifen.com (14.213.177.38) from 192.168.1.12 eth0: 96(84) bytes of data. 


64 bytes from 14.213.177.38 (14.213.177.38): icmp sedq=]l tt=S6 ttime=0.74 mas 
64 bytes from 14.215.177.38 (14.213.177.38): icmp_ seq=2 t=56 time=0.80 ms 
64 bytes from 14.215.177.38 (14.213.177.38): icmp_seq=3 tl=5S6 time=0.20 ms 
64 bytes from 14.213.177.38 (14.213.177.38): icmp sedq=4 ttl=S6 time=7.27 ms 
ee 

--- WwWWw.a.Shifen.com ping statistics --- 

4 packets transmitted, 4 recelived, 0% packet loss, ttme 3002ms 

rtt min/avg/max/mdev = 60.260/6.770/7.273/0.373 ms 


3. 21. USB 摄像 头 测试 


1) 首先 将 USB 摄像 头 插 入 到 Orange Pi 开发 板 的 USB 接口 中 


2) 然后 通过 lsmod 命令 可 以 看 到 内 核 自 动 加 载 了 下 面 的 模块 
alinux4.9 系统 显示 如 下 所 示 


root@Oorangepi:~#]lsmod | grep "uvecy" 
Module Size Used by 
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uvcvideo 106496 0 
blinux5$.4 系统 显示 如 下 所 示 
root@Oorangepi:~#]lsmod | grep "uvecy" 


uvcvideo 102400 0 

videobuf2 vmalloc 20480 Tuvcvideo 

videobuf2 v412 28072 Tuvcvideo 

videobuf2 _ common S3248 2 Videobuf2 _ v412,uvcvideo 

videodev 233472 3 videobuf2 v412,uvcvideo,videobuf2 _ common 
mec 491S2 4 


videodevvideobuf2 v4l2,uvcvideo,videobuf2 common 


3) 通过 v412-ctl (注意 v412 中 的 1 是 小 写字 母 1， 不 是 数字 1) 命令 可 以 看 到 USB 
摄像 头 的 设备 节点 信息 为 /devvideo0 
rootOorangepi:~##apt update 


rootOorangepi:~#apt install v4l-utils 

rootOorangepi:~#v412-ct  --list-devices 

IUSB 2.0 Camera (usb-xhcli-hcd.0.auto-1.2): 
/dev/video0 


4) 使 用 fwebcam 测试 USB 摄像 头 
a. 安装 全 webcam 


rootOorangepi:~##apt update 


root(Oorangepi:~##apt-get install fwebcam 
b.， 安装 完 人 webcam 后 可 以 使 用 下 面 的 命令 来 拍照 
aj) -d 选项 用 于 指定 USB 摄像 头 的 设备 节点 
b) “--no-banner 用 于 去 除 照片 的 水 印 
c) -< 工 选项 用 于 指定 照片 的 分 辩 率 
d) -S 选项 用 设置 于 跳 过 前 面 的 帧 数 
e) image.jpg 用 于 设置 生成 的 照片 的 名 字 和 路 径 
rootorangepi:~#fswebcam -d /dev/video0 --no-banner -r 1280x720 -S S ./image.jpg 
c.， 在 服务 器 版 的 linux 系统 中 ， 拍 完 照 后 可 以 使 用 scp 命令 将 拍 好 的 图 片 传 到 
Ubuntu PC 上 镜像 观看 
rootorangepi:~# scp image.jpg test@192.168.1.SS:/home/test 〈 根 据 实际 情 况 修 吏 
IE 地 址 和 路 径 ) 
d， 在昌 面 版 的 linux 系统 中 ， 可 以 通过 HDMI 显示 器 直接 查看 拍摄 的 图 片 
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5) 使 用 motion 测试 USB 摄像 头 
a. 安装 摄像 头 测试 软件 motion 
rootOorangepi:~#apt update 


root(Oorangepi:~##apt install motion 
b， 修改 /etc/defaultymotion 的 配置 ， 将 start motion daemon=no 修改 为 
start motion daemon=yes 


root(Oorangepi:~#sed -i"s/start_ motion daemon=no/start motion daemon=yes/"\ 
etc/default/motion (这 是 一 条 命令 ) 
c. 修改 /etwmotion/motion.conf 的 配置 
rootOorangepi~##sed -i"s/stream _ localhost on/stream _ localhost off/"、\ 
etc/motion/motion.conf (这 是 一 条 命令 ) 


d.， 然后 重启 motion 服务 
root(Oorangepi:~ 和 ##/etc/init.d/motion restart 


[ ok ] Restarting motion (Via SystemctD): motion.Service. 


e. 使 用 motion 前 请 先 确保 Orange Pi 开发 板 能 正常 连接 网 络 , 然后 通过 ifconfig 
命令 获取 开发 板 的 耳 地 址 

f 然后 在 和 开发 板 同 一 局 域 网 的 Ubuntu PC 或 者 Windows PC 或 者 手机 的 火狐 
浏览 器 中 输入 【开发 板 的 卫 地 址 :8081】 就 能 看 到 摄像 头 输出 的 视频 了 


68.1.12.8081 所 一 一 这 里 输入 开发 板 的 IP 地 址 +8081 端 口号 


6) 使 用 mjpg-streamer 测试 USB 摄像 头 
a 下 载 mjpg-streamer 


root(Oorangepi:~## git clone https://github.comy/jacksonliam/mjpg-streamer 


b.， 安装 依赖 的 软件 包 
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rootOorangepi~##apt-get install cmake libjpeg8-dev 


c.， 编译 安装 mjpg-streamer 


rootOorangepi~##cd mjpg-streamer/mjpg-streamer-experimental 


rootOorangepi~/mjpg-streamermjpg-streamer-experimental# make 


root(Oorangepli:~/mjpg-streamervmjpg-streamer-experimental# make install 
d， 然后 输入 下 面 的 命令 启动 mjpg_streamer 
rootOorangepi~/mjpg-streamermjpg-streamer-experimental# export 
LD LIBRARY PATH=. (这 是 一 条 命令 ) 
rootorangepi:~/mjpg-streamermjpg-streamer-experimental# ./mjpg_streamer -i 
"Jinput_ uvec.So -d /dev/video0 -u -f30" -0 "./output http.so -wW ./wwwy" 

e. 然后 在 和 开发 板 同 一 局 域 网 的 Ubuntu PC 或 者 Windows PC 或 者 手机 的 浏览 

器 中 输入 【开发 板 的 瑟 地 址 :8080】 就 能 看 到 摄像 头 输出 的 视频 了 


< G 自 口 吝 192.168.1167 在 浏览 器 中 输入 开发 板 的 I|P 地 址 +8080 端 口号 


Pags Stream 


Displaythestream 


Hints 


Source snippet 


f 推荐 使 用 mjpg-streamer 来 测试 USB 摄像 头 ， 比 motion 流畅 很 多 ， 使 用 
mjpg-streamer 感觉 不 到 任何 卡 顿 


3. 22. linux4.9 系统 OTG 功能 测试 


3. 22. 1._ OFTG 功能 说 明 


D) OTG 接口 的 位 置 如 下 图 所 示 , 此 接口 既 可 设置 为 USB Host 模式 来 接 U 盘 、 鼠 标 、 
键盘 、USB 摄像 头等 设备 , 也 可 设置 为 USB device 模式 将 开发 板 连 接 到 电脑 来 通信 
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OTG 接 口 


2) 当 OTG 接口 设置 USB Host 模式 时 ， 需 要 准备 一 根 micro USB 转 otg 的 转 接线 才 
能 接 USB 设备 


-= 


3) 使 用 OTG 接口 时 ， 请 使 用 DC 电源 来 给 开发 板 供电 ， 电 脑 的 USB 接口 无 法 提供 
足够 的 功率 来 驱动 开发 板 


使 用 DC 接口 给 开发 板 供电 


3. 22. 2. 0TG 接口 设置 为 USB Host 模式 的 使 用 方法 


1) linux4.9 镜像 OTG 接口 默认 设置 为 usb_ host 模式， 可 以 通过 下 面 的 命令 来 查看 
otg_role 的 状态 

root(Oorangepi:~ 和 ## cat /Sys/devices/platform/soc/usbc0/otg_ role 

usb host 


Www.orangepi.cn 69 Www.Xxunlong.tv 


首 range Pi 用 户 手册 深圳 市 迅 龙 软件 有 限 公司 版 权 所 有 
2) 如 果 otg role 没有 设置 为 usb_ host 模式 ， 可 以 使 用 下 面 的 命令 打开 


root(Oorangepi:~#cat /Sys/devices/platform/soc/usbc0/usb host 
host chose finished! 


3) 确认 otg_ role 的 模式 为 usb_host 后 , 驶 可 以 将 OTG 转 接 线 插入 到 开发 板 的 Micro 
USB 接口 中 ， 然 后 在 OTG 转 接线 的 USB 接口 中 插入 想 连 接 的 USB 设备 即 可 


4) 如 果 接 入 的 USB 鼠标 、 键 盘 、U 盘 或 者 USB 摄像 头 使 用 正常 ， 说 明 OTG 接口 
的 USB Host 能 正常 使 用 


3. 22. 3._ 0OTG 虚拟 UsB 网 卡 测试 
1) 首先 需要 使 用 Micro USB 接口 的 数据 线 将 开发 板 连 接 到 电脑 的 USB 接口 中 


2) 然后 使 用 下 面 的 命令 将 otg tole 设置 为 usb device 模式 
root(Oorangepi:~#cat /Sys/devices/platform/soc/usbc0/usb device 


device_chose finlished! 


3) 然后 加 载 g_ether 内 核 模 块 
rootOorangepi:~#modprobe g_ether 


4) 加 载 完 内 核 模 块 后 开发 板 就 会 多 出 一 个 名 为 usb0 的 网 络 接口 ， 首 先 使 能 这 个 网 
络 接口 ， 然 后 给 其 设置 下 地 址 
rootOorangepi:~##ifconfig usb0 up 
root(Oorangepi:~#jifconfig usb0 192.168.10.10 
rootOorangepi~## 过 config usb0 
usb0: flags=4163<UPBROADCASTRUNNING,MULIICAST> mtu 1500 
inet 192.108.10.10 netmask 233.233.233.0 broadcast 192.168.10.253 
inet0 fe80::180e:b0fffeSa:lee4 prefixlen 64 scopelid 0x20<link> 
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ether 1a:0e:b0:Sa:le:e4 txqueuelen 1000 (Ethernet) 

RX packets 47 bytes 8223 (8.2 KB) 

RX errors 0 dropped 0 overruns 0 frame 0 

TX packets 47 bytes 8223 (8.2 KB) 

TX errors 0 _ dropped 0 overruns 0 carrier 0 collisions 0 


5) 然后 回 到 Ubuntu PC 中 ， 可 以 看 到 多 了 一 个 名 为 usb0 的 网 卡 〈 也 有 可 能 为 其 他 
的 名 字 ， 以 实际 情况 为 准 ) 
testtest:~$ ifconfig usb0 
usb0: flags=4163<UPBROADCASTRUNNING,MULIICAST> mtu 1500 
ether f6:94:ac:00:88:c6 txqueuelen 1000 〔〈 以 太 网 ) 
RX packets 12 bytes 760 (760.0 B) 
RX errors 0 dropped 0 overruns 0 frame 0 
TX packets 96 bytes 17733 (17.7 KB) 
TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 


6) 然后 在 Ubuntu PC 中 给 USB 虚拟 网 卡 分 配 卫 地 址 ，Ubuntu PC 的 下 地 址 请 和 开 
发 板 的 卫 保持 在 同一 网 段 内 

testtest:~$ sudo ifconfig usb0 192.168.10.12 

testtest:~$ ifconfig usb0 

usb0 : flags=4163<UPBROADCASTRUNNING,MULTICAST> mtu 1500 

inet 192.108.10.12 netmask 233.233.233.0 broadcast 192.168.10.253 
ether aa: 亿 :32:84:93:3$ ”txqueuelen 1000 (以 太 网 ) 

RX packets 930 bytes 8342 (8.3 KB) 

RX errors 0 dropped 0 overruns 0 frame 0 

TX packets 113 bytes 21351 (21.3 KB) 

TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 


QI 


7) 然后 就 可 以 测试 开发 板 和 Ubuntu PC 是 否 可 以 相互 通 1 


rootorangepi:~##ping 192.168.10.12 

PING 192.168.10.12 (192.168.10.12) S6(84) bytes of data. 

64 bytes from 192.168.10.12: icmp seq=l ttl=04 time=0.370 mas 
64 bytes from 192.168.10.12: icmp seq=2 ttl=04 time=0.349 mas 
64 bytes from 192.168.10.12: icmp seq=3 ttl=64 titme=0.460 mas 
64 bytes from 192.168.10.12: icmp seq=4 ttl=04 time=0.460 mas 
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64 bytes from 192.168.10.12: icmp seq=9 ttl=04 titme=0.493 mas 
作坊 


3. 22. 4 0TG 虚拟 串口 测试 
1) 首先 需要 使 用 Micro USB 接口 的 数据 线 将 开发 板 连 接 到 电脑 的 USB 接口 中 


2) 然后 使 用 下 面 的 命令 将 otg role 设置 为 usb _ device 模式 
root(Oorangepi:~#cat /Sys/devices/platform/soc/usbc0/usb _device 


device_chose finlished! 


3) 然后 加 载 g_serial 内 核 模块 
rootorangepi:~# modprobe g_serial 


4) 加 载 完 内 核 模 块 后 开发 板 linux 系统 的 /dev 下 面 就 会 多 出 一 个 名 为 ttyGS0 的 设备 
节点 

root(Oorangepi:~##js /dew/ttyGS+ 

dewttyGS0 


5) 然后 回 到 Ubuntu PC， 可 以 看 到 /dey 下 面 会 多 了 一 个 名 为 ttyACM0 的 设备 节点 
testtest:~$ ls /devttyACME* 
dewttyACM0 


6) 然后 打开 Ubuntu PC 的 putty， 连 接 ttyACM0 
testtest:~$ sudo putty 
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PuTTY Configuration ER 


Category: Options controlling local seriallines 
LoggIng Selecta serialline 


Y Terminal 人 
Serial line to connect to /dewttyACM0 
Keyboard 


Bell Configure the serialline 


Features Speed (baud) 115200 
T Window 
Appearance Data bits 8 
Behaviour Stop bits 1 
Translation 
Selection 
Colours Elow control None 一 
Fonts 


Parity None 下 


Connection 
Data 
Proxy 
Telnet 
Rlogin 

SSH 


About Open Cancel 


Putty 连接 好 ttyACM0 后 会 打开 下 图 所 示 的 窗口 


jdewttyACM0 - PuTTY 


7) 然后 回 到 开发 板 的 linux 系统 ， 给 /dewttyGS0 发 送 一 串 字 符 


root@Oorangepi:~#echo "Test Orange Pi" > /dev/ttyGS0 


8) 如 果 一 切 正常 ，Ubuntu PC 的 Putty 就 会 收 到 开发 板 发 送 过 来 的 字符 有 


也 
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/dewttyACM0 - PuTTY 


Test Drange Pi 


3. 22. 5._ 0OTG 虚拟 U 盘 
1) 首先 需要 使 用 Micro USB 接口 的 数据 线 将 开发 板 连接 到 电脑 的 USB 接口 中 


NS 


2) 然后 使 用 下 面 的 命令 将 otg role 设置 为 usb_device 模式 
rootOorangepi:~# cat /Sys/devices/platform/soc/usbc0/usb_ device 


device_chose finlished! 


3) 然后 查看 下 eMMC 的 设备 节点 名 〈 必 须 是 贴 有 eMMC 的 Orange Pi 3 开发 板 才 
有 ) ， 使 用 1 /dewmmeblkx 命 令 可 以 列 出 系统 中 识别 到 的 所 有 MMSC/SD 存储 设备 
的 节点 ，mmcblk0boot0 和 mmcblk0bootl 是 eMMSC 中 的 分 区 ， 所 以 eMMSC 的 设备 
节点 为 /dewmmcblk0。 其 中 /devwmmcblkl 为 TF 卡 的 设备 节点 

如 果 eMMC 中 出 广 烧 录 的 安 虑 系统 没有 被 覆盖 ,就 可 以 看 到 下 面 所 示 的 十 几 个 
设备 节点 名 ， 如 果 你 烧 录 过 linux 系统 到 eMMSC 中 或 格式 化 过 eMMC， 那 么 就 看 不 
到 这 个 多 的 设备 节点 名 ， 可 能 只 有 一 两 个 
rootorangepli3:~ 和 ##1s /dev/mmcblks* ， 
devmmcblk0 /devmmcblk0op1l /devmmcblk0p12 /devmmcblk0p1l 
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devmmcblk0p2 /devmmcblk0p6 /devwmmcblk0p9 
dev/mmcblk0boot0 /dev/mmcblk0Op10 /devmmcblk0p13 /devmmcblkop16 
devmmcblk0p3 /devmmcblk0p7 /dewmmcblkl 
dev/mmcblk0bootl /devmmcblkop11l /devmmcblk0p14 /devmmcblk0op17 


devmmcblk0ps /devmmcblk0p8 /devwmmcblklp1l 


4) 然后 加 载 g_mass_storage 内 核 模 块 ， 其 中 /devwmmcblk0 表示 将 eMMC 虚拟 成 TU 
盘 


rootorangepi~#Imodprobe g_mass storage file=/dev/mmcblk0 stall=0 


removable=1I 


5) 加 载 完 内 核 模 块 后 Ubuntu PC 中 就 可 以 看 到 多 了 一 个 或 多 个 U 盘 设 备 , 当 eMMSC 
中 的 Android 系统 没有 被 破坏 时 ， 可 以 看 到 下 面 的 多 个 分 区 设备 。 如 果 eMMSC 中 烧 
录 了 1linux 镜像 ， 那 么 加 只 会 看 到 一 个 U 盘 设 备 

Itest(Otest:~$ ls /media/test/ 

7 人 名 似 bc-ab 全 -65Sf-bf67-946fc0fof25Sb 7 人 全 bc-ab 全 -65$Sf-bf67-946fc0f9f25Sbl] 
3986B-07E3 system Volumn 


6) 此 时 就 可 以 把 eMMSC 当成 U 盘 来 用 ， 可 以 对 它 格式 化 ， 找 贝 文件 等 操作 ， 当 然 
也 可 以 直接 在 Ubuntu PC 中 烧 录 linux 镜像 到 eMMC 中 ， 步 又 如 下 所 示 
a. 打开 balenaEtcher 软件 ， 选 择 要 烧 录 的 linux 镜像 ， 然 后 选择 设备 为 /dewsdx 
《修改 为 eMMC 对 应 的 设备 ) ， 从 下 图 可 以 看 到 eMMC 的 大 小 为 7.82GB 


Etkcher 


balena 


@ 晶 一 一 昌 


Orangepi3...9.118.img Compute Module 


b. 再 点 击 Flash 开始 烧 录 linux 镜像 到 eMMC 中 , 和 虐 录 linux 镜像 到 TEF 卡 的 


步骤 一 样 
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7) 烧 录 linux 镜像 到 eMMC 中 后 ， 就 可 以 关闭 开发 板 ， 然 后 拔 出 TF 卡 ， 再 启动 开 
发 板 ， 就 会 运行 seMMSC 中 的 linux 系统 了 


3. 23. 音频 测试 


注意 :， linuxS.4 系统 不 支持 耳机 播放 和 MIC 录音 ， 只 有 1linux4.9 系统 支持 
3. 23. 1._ linux4.9 系统 耳机 接口 播放 音频 测试 
1) 首先 在 音频 接口 中 插入 耳机 


2) 通过 aplay -! 命令 可 以 查看 linux 系统 文 持 的 声卡 设备 ， 其 中 sndacx00codec 就 
是 耳机 播放 需要 的 声卡 设备 

rootOorangepi:~##aplay -1 

六 水 半 List of PLAYBACK Hardware DeviceS 闪闪 六 迷 

card 0: sndhdmi [sndhdmil, device 0: SUNXI-HDMIAUDIO audiohdmi-dai-0 [ 
Subdevices: 1/1 
Subdevice 如 : Subdevice 如 

card 1: sndacXx00codec [sndacx00-codecl, device 0: SUNXI-AUDIO acxX00-dai-0 [] 
Subdevices: 1/I 
Subdevice #0: subdevice #0 


3) 上 传 需要 播放 的 音频 文件 到 linux 系统 的 foot 文件 夹 中 , 在 Ubuntu PC 中 可 以 使 
用 scp 命令 上 传 (命令 中 的 卫 地 址 为 Orange Pi 开发 板 的 卫 地 址 )， 或 者 使 用 
盘 拷贝 

testQtest:~/AudioTest$y scp audio.wav root@192.168.1.xx:/root 〈 根 据 实际 情况 修 

改 卫 地址 和 路 径 ) 


4) 然后 使 用 aplay 命令 播放 音频 ， 耳 机 就 能 听 到 声音 
rootOorangepi:~#aplay -D hw:10 audio.wav 
Playing WAVE 'audio.wav' : Signed 16 bit Little Endian, Rate 44100 Hz, Stereo 


3. 23. 2， linux4.9 系统 MIC 录音 测试 
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rootOorangepi:~# arecord -D hw:1.0 -d S -fcd -t way test.wav 
Recording WAVE 'test.,wav' : Signed 16 bit Little Endian, Rate 44100 Hz, Stereo 


2) 录音 完毕 后 会 在 当前 路 径 下 生成 一 个 名 为 test,warv 的 录音 文件 ， 使 用 aplay 命令 
可 以 播放 testwav 来 查看 是 否 有 声音 输出 ， 如 果 有 声音 输出 ， 交 明 录 音 正常 
rootOorangepi:~#j]s -jh 

total 864 开 

-TW-T--T-- 1 root Toot 862K Dec 1 006:23 test.wWav 

root@Oorangepi:~##aplay -D hw:1,0 test.wav 


3. 23. 3._HDMI 音频 播放 测试 


1) 首先 使 用 HDMI 线 将 Orange Pi 开发 板 连接 到 电视 机 上 《其 他 的 HDMI 显示 吉 需 
要 确保 可 以 播放 音频 ) 


2) 上 传 需要 播放 的 音频 文件 到 linux 系统 的 foot 文件 夹 中 ， 在 Ubuntu PC 中 可 以 使 
用 scp 命令 上 传 (命令 中 的 卫 地 址 为 Orange Pi 开发 板 的 卫 地 址 )， 或 者 使 用 U 盘 拷 
贝 

test@Qtest:~/AudioTest$y scp audio.wav root@192.168.1.xx:/root 〈 根 据 实 际 情况 修 
改 卫 地 址 和 路 径 ) 


3) HDMI 音频 播放 无 需 其 他 设置 ， 直 接 使 用 aplay 命令 播放 即 可 
rootOorangepi:~##aplay -D hw:0,0 audio.wav 


3. 24. 红外 接收 测试 


1D) 安装 ir-keytable 红外 测试 软件 
rootOorangepi:~#apt update 


rootOorangepi:~##apt-get install ir-keytable 


2) 然后 执行 ir-keytable 可 以 查看 红外 设备 的 信息 
a linux4.9 系统 输出 如 下 所 示 
root@Oorangepi:~#ir-keytable 


Found /Sys/classrc 人 rcO/ (/dewinputevent4) with: 


Driver Sunxi-rc-recv, table rc_ map Sunxi 
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Supported protocols: nec 

Enabled protocols: nec 

Name: Sunxi-ir 

bus: 2$, vendor/product: 0001:0001, verslion: 0x0100 

Repeat delay = 500 ms, repeat period = 123 mas 
blinux5.4 系统 输出 如 下 所 示 
root(Oorangepi:~##1r-keytable 


Found /Sys/classMrc 人 rcO/ (/dewinputeventl) with: 

Name: Sunxi-ir 

Driver: Sunxi-ir, table: rc-empty 

LIRC device: /dewlirc0 

Attached BPF protocols: Operation not supported 

Supported kernel protocols: other lirc rc-3 rc-S-Sz jvc Sony nec Sanyo mce kb 
Enabled kernel protocols: lirc 

bus: 2$, vendor/product: 0001:0001, verslion: 0x0100 

Repeat delay = 300 ms, repeat period = 123 mas 


3) 测试 红外 接收 功能 前 需要 准备 一 个 红外 遥控 器 


4) 然后 在 终端 中 输入 ifKeytable -t 命令 ， 再 使 用 红外 遥控 吉 对 着 Orange Pi 开发 板 
的 红外 接收 头 按 下 按键 就 能 在 终端 中 看 到 接收 到 的 按键 编码 了 

a、 linux4.9 系统 输出 如 下 所 示 
root(Oorangepi:/#ir-keytable - 


Testing events. Please, press CTRL-C to abort. 

1598339132.260376: event type EV_MSC(0x04): scancode = 0Oxfb0413 
15$98339152.260376: event type EV_SYN(Ox00)， 

1598339132.914713: event type EV_MSC(0x04): scancode = 0Oxfb0410 
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blinux5.4 系统 输出 如 下 所 示 


root(Oorangepi:~#jr-keytable -c -p NEC -t 

Old keytable cleared 

Protocols changed to nec 

Testing events. Please, press CTRL-C to abort， 

3161.772202: lirc protocol(nec): Scancode = 0x43c 
3161.772323: event typeEV_MSC(0Ox04): scancode = 0x43c 
3101.772323: event type EV_SYN(0x00)， 


3. 25. 温度 传感器 


1) H6 总 共有 2 个 温度 传感器 ， 查 看 温度 的 命令 如 下 
a._ Sensor0: CPU 


法 


root(Oorangepi:~# cat /Sys/class/thermalthermal zone0/type 
cpu thermal zone 

rootOorangepi:~# cat /Sys/class/thermalthermal zone0/temp 
S7734 


b.， sensorl1: GPU 


rootOorangepi:~# cat /Sys/class/thermal/thermal zonel/type 
gpu thermal zone 

rootOorangepi:~# cat /Sys/class/thermal/thermal zonel/temp 
S7410 


3. 26. 安装 Docker 的 方法 


1) 先 介 载 可 能 存在 的 旧版 本 docker 


root(Oorangepi:~#apt remove docker docker-engine docker-ce docker.io 


2) 然后 安装 下 面 的 软件 包 


root@Oorangepi:~##apt update 
rootOorangepi:~#apt install -y apt-transport-https ca-certificates curl 
software-properties-common (这 是 一 条 命令 ) 


3) 再 谎 加 阿里 云 docker 的 密 铂 
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rootOorangepi:~# curl -fsSL http:/mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg 
| sudo apt-keyadd  - (这 是 一 条 命令 ) 


4) 在 ubuntu 的 系统 源 中 添加 对 应 的 docker 源 


rootOorangepi:~##add-apt-repository "deb [arch=arm04] 
https:/mirrors.aliyun.com/docker-ce/linux/ubuntu $(dsb _ release -cs) stable” 


(这 是 一 条 命令 ) 


$) 安装 最 新 版 本 的 docker-ce 


rootOorangepi:~##apt update 


rootOorangepi:~#apt install docker-ce 


6) 验证 docker 的 状态 


rootOorangepi:~#Systemectl status docker 
@ docker.Service - Docker Application Container Engine 
Loaded: loaded WUlib/systemd/systemy/docker.service; enabled; vendor preset': enabled) 
Active: active (running) since Mon 2020-08-24 10:29:22 UTC; 26min ago 
Docs: https://docs.docker.com 
Main PID: 3143 (dockerd) 
Tasks: 1 
CGroup: /System.slice/docker.service 
[一 3145 /usrbin/dockerd -再 fd:/ 


--containerd=/run/containerd/containerd.Sock 


7) 测试 docker 


rootOorangepi:~#docker run hello-world 

IUnable to find image hello-world:latest locally 

latest: Pulling from 1library/hello-world 

236ab8fe8778: Pull complete 

Digest: 
sha256:7f0a9fo93b4aa3022c3a4c147a449eflle0941alfd0bfa8se6c9408b2600777c5 


Status: Downloaded newer Image for hello-world:latest 


Hello from Docker! 


This message Shows that your installation appears to be working correctly. 
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3. 27. 26 Pin 接口 引 脚 说 明 


ID) OrangePi3 开发 板 26 pin 接口 引 脚 的 顺序 请 参考 下 
2 号 引 脚 29 号 引 肢 


2) Orange Pi 3 开发 板 26 pin 接口 引 脚 的 功能 如 下 表 所 示 


GPI0 序 号 | GPI0 功能 引 脚 引 脚 功能 GPI0O | GPI0 序 号 

3.3V 1 2 5V 

122 PD26 | TWIO-SDA 3 4 5V 

121 PD25 | TWIO-SCK 5 6 GND 

118 PD22 PWM0 7 8 S-UART_TX | PL2 354 
GND 9 10 S-UART_RX | PL3 355 

120 PD24 | UART3_RX 11 12 PD18 PD18 114 

119 PD23 | UART3_TX 13 14 GND 

362 PL10 PLI10 15 16 PD15 PD15 111 
3.3V 17 18 PD16 PD16 112 

229 PH5 | SPI1 MOSI | 19 20 GND 

230 PH6 | SPI1 MISO | 21 22 PD21 PD21 117 

228 PH4 | SPIl CLK | 23 24 SPI1_CS PH3 227 
GND 25 26 PL8 PL8 360 


3. 28. 安装 wiringOP 的 方法 


1D) 下 载 wiringOP 的 代码 


root(Oorangepi:~##aptupdate 
rootOorangepi~##apt install git 


root(Oorangepi:~ 和 # git clone https://github.com/orangepi-xunlong/wiringOP 
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2) 编译 wiringOP 
root(Oorangepi:~ 坟 cd wiringOP 


root(Oorangepi:~/wiringOP# ./build clean 


root(Oorangepli:~/wiringOP# .builda 


3) 测试 gpio readall 命令 的 输出 如 下 ， 其 中 1 到 26 号 物理 引 脚 与 开发 板 上 的 26 Pin 
引 脚 是 一 一 对 应 的 


Physical 


3. 29. 26pin 接口 GPIO0、I2C、UART、SPI 测试 


wiringOP 已 适 配 Orange Pi 3 开发 板 , 使 用 wiringOP 可 以 测试 GPIO、 DC、UART 
和 SPI 的 功能 


3. 29. 1._ 26pin GPIO 口 测 试 


1) 下 面 以 7 号 引 脚 一 一 对 应 GPIO 为 PD22 一 一 对 应 wPi 序号 为 2 一 
何 设置 GPIO 口 的 高 低 电 平 


为 例 演示 如 
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OPiI 3 +--- 
| Mode | V | PhysicaL | V 


2) 首先 设置 GPIO 口 为 输出 模式 ， 其 中 第 三 个 参数 需要 输入 引 脚 对 应 的 wPi 的 序号 
rootOorangepi~/wiringOP# gpio mode 2 out 


使 用 gpio readall 可 以 看 到 7 号 引 脚 的 模式 (mode) 变 为 了 out 
# gpio readalLL 


3) 然后 设置 GPIO 口 输出 低 电 平 ,设置 完 后 可 以 使 用 万 用 表 测 量 引 脚 的 电压 的 数值 ， 
如 果 为 0v， 说 明 设 置 低 电 乎 成功 
rootOorangepi~/wiringOP# gpio write 2 


使 用 gpio readall 可 以 看 到 7 号 引 脚 的 值 (V) 变 为 了 0 
# gpio readalLL 


4) 然后 设置 GPIO 口 输出 高 电 平 ,设置 完 后 可 以 使 用 万 用 表 测 量 引 脚 的 电压 的 数值 ， 
如 果 为 33v， 说 明 设 置 高 电 平成 功 


rootOorangepi~/wiringOP# gpio write 2 
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使 用 gpio readall 可 以 看 到 7 号 引 脚 的 值 (V) 变 为 了 1 


$) 其 他 引 脚 的 设置 方法 类 似 ， 只 需 修 改 wPi 的 序号 为 引 脚 对 应 的 序号 即 可 
3. 29. 2._ 26pin SPl 测试 


1) linux5.4 系统 在 dts 中 默认 关闭 了 26pin 中 的 spi 控制 器 ， 如 果 需 要 使 用 spi， 首 先 
需要 先 打开 spi 的 配置 ，linux4.9 系统 默认 都 是 打开 的 ,不 需要 额外 的 配置 ,linux5.4 
系统 spi 的 打开 方法 如 下 所 示 : 

a 由 ?26pin 的 原理 图 可 知 ， 开 发 板 可 用 的 spi 为 spil 


VCcC-IO 1 - 9 
iDSDA 3 | 3.3V1 
SDA 5.0V2 上 6 
TWIO-SCK5 | EN |reNo 
Pww k 还: 和 和 
De 10 发 S-UART-RX 
UART3-RX 访 ”PD18 
UART3-TX 人 UART 下 GND 
GND4 [6 | 
过 人 
20 
SPI1- FT 一 MOS| GND5 -条 一 No 
SPI1-MISO 一 一 当 SPLMISO PD21 
SPl-CUK KRCEO 上 和 spns 
GND || 六 一 | GND2 ”SFWRU 


b.， 然后 在 bootVorangepiEnv.txt 二 overlays=spi-spidev1 
overlays=spi-spidev1 
c. 然后 重启 系统 ， 启 动 时 ， 在 u-boot 的 启动 log 中 可 以 看 到 SPI DT overlays 
的 配置 输出 
Applying kernel provided DT overlay sunS0i-h6-spi-spidev1.dtbo 
4191 bytes read in 6 ms (681.6 KIB/S) 
IApplying kernel provided DT fixup script (Sun50i-h6-fixup.scT) 
d.， 系统 局 动 后 ， 在 /dev 下 如 果 可 以 看 到 SPI 的 设备 节点 就 说 明 配 置 正月 
root(Oorangepi:~##]s /dev/Sp 这 
dev/Spidev1.0 


GEHN 
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2) 再 在 wiringOP 的 examples 中 编译 spidev _ test 测试 程序 
root@Oorangepi:~/wiringOP/examples# make spidev_ test 
[CC] spldev test.c 

[in 


3) 先 不 短 接 SPI] 的 mosi 和 miso 两 个 引 脚 ,运行 spidev _test 的 输出 结果 如 下 所 示 ， 
可 以 看 到 TX 和 RX 的 数据 不 一 臻 
root@Oorangepi:~/wiringOP/examples# ./Spidev test -V -D /dev/Spidev1.0 


spi mode: 0x0 

bits per word: 8 

Imax speed: 900000 Hz (300 天 Hz) 
TX IEFEFEEFEFEEFFFEFEFEF40000000009SFFFFEFFEFEFEEFFEFEFEFEEEFFEFEFEFEFEEFFEH 
FFEFFEFFFFFFFOOD | 
RX |FFEFFEFEEFEEEFEFFFEEFEFFEFFEFFEFEFFEFEFFEFEFFEFFEEFFEFFEFEEFEEFEEFFEFEFEFEEEH 
EDERIRRIRRIRESEEIEE EREE | 人 于 


4) 然后 短 接 SPI] 的 mosi (26pin 接口 中 的 第 19 号 引 脚 )》 和 miso (26pin 接口 中 的 
第 21 号 引 脚 ) 两 个 引 脚 再 运行 spidev_test 的 输出 如 下 ， 可 以 看 到 发 送 和 接收 的 数据 
一 样 
root@Oorangepi:~/wiringOP/examples# ./Spidev_ test -V -D /dev/spidev1.0 


spi mode: 0x0 
bits per word: 8 
Imax speed: 900000 Hz (300 KHz) 


3. 29. 3. 26pin 12C 测试 
1) linux5.4 系统 在 dts 中 默认 关闭 了 26pin 中 的 ic 控制 器 ,如 果 需 要 使 用 jc， 首先 


需要 先 打开 i2c 的 配置 ,linux4.9 系统 默认 都 是 打开 的 , 不 需要 额外 的 配置 ，linux5.4 
系统 i2c 的 打开 方法 如 下 所 示 ; 
昌 26pin 的 原理 图 可 知 ， 开 发 板 可 用 的 i2c 为 i2c0 


a. 


[IE 
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VCC-5V 
VCC-IO 
|GND 
局 3 《 S-UART-RX 
UART3-RX IO_ 0 公 PD18 
UART3-TX IO 2? 卜 ND 
PE 一 《KR IO23 PD15 
VCC-IO 3 3v2 PD16 
SPI1-MOSI SPI MOSI ND 
SPI1-MISO SPIL MISO IO _6 PD21 
SPI1-CLK SPL CLK SPIL CE0 上 56 SPlI1-CS 
GND)| GND2 。” S-PWM0 PL8 


b. 然后 在 /bootorangepiEnv.txt 中 设置 overlays=i2c0 就 可 以 打开 i2c0 的 配置 
overlays=i2c0 

c. 然后 重启 系统 ， 启 动 时 ， 在 uboot 的 启动 log 中 可 以 看 到 IC DT overlays 

的 配置 输出 

Applying kernel provided DT overlay sunS0i-h6-i2c0.dtbo 
4191 bytes read in ms (818.4 KIB/S) 
IApplying kernel provided DT fixup script (Sun50i-h6-fixup.scT) 

d， 系统 启动 后 ， 在 /dey 下 如 果 多 了 个 i2c 的 设备 节点 就 说 明 配 置 正 胡 
root(Oorangepi:~##]1S /dewi2ct 
dewi2c-0 /dewi2c-1 /dewi2c-2 /devwi2c-3 

e.， 不 同 的 ic 设备 节点 的 对 应 关系 如 下 所 示 ， 其 中 

al) 26pin 中 的 i2c0 对 应 /dewi2c-0 


GEHN 


:-# LS /SYS/CLasSs/i2c-adapter/i2c-# -Lh 
Lrwxrwxrwx 1 root root 0 Dec 7 12:56 
Lrwxrwxrwx 1 root root 0 Dec 7 12:56 


Lrwxrwxrwx 1 root root 0 Dec 7 12:56 
Lrwxrwxrwx 1 root root 0 Dec 7 12:57 


2) 然后 开始 测试 2c， 首 先 安 装 Pc-tools 
rootOorangepi~##aptupdate 


rootorangepi:~##apt install i2c-tools 


3) 然后 在 26pin 接头 的 ic0 引 脚 上 接 一 个 ic 设备 


12c0 
sda 引 脚 对 应 3 号 引 脚 
sck 引 脚 对 应 5 号 引 脚 
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vcc 引 脚 对 应 1 号 引 脚 
gnd 引 脚 对 应 6 号 引 脚 


4) 然后 使 用 记 cdetect -y 0 命令 如 果 能 检测 到 连接 的 i2c 设备 的 地 址 ， 就 说 明 i2c 能 
正常 使 用 


:~## LI2Ccdetect -y 3 
人 DO 


3. 29. 4. 26pin 的 UART 测试 


1) linux5.4 系统 在 dts 中 默认 关闭 了 26pin 中 的 uart 控制 器 ， 如 果 需 要 使 用 uart， 首 
先 需要 先 打开 uart 的 配置 ，linux4.9 系统 默认 都 是 打开 的 ， 不 需要 额外 的 配置 ， 
linux5.4 系统 uart 的 打开 方法 如 下 所 示 : 


a 由 26pin 的 原理 图 可 知 ， 开 发 板 可 用 的 uart 为 uart3 
vcc-5V 


VCC-IO ] 
WIDESDA 3 | 3 和 
TWIDSCK 
SCL IGND 
PWMO 必 号 -0 六 S-UART-TX 
SNDH riP & S-UART-RX 
UART3RX <CURRTSRXT | 1 PD18 
UART XUARTET [Te 
5 站 时 GND4 一 一 刘 : 

[RE 4 
SPI1-MOSI J 寺 | SPL MOSI 。 GND5 务 一 站 ND 
SRILMISO SPLMISO ”1I0_6 上 气 FD21 

SPICLK SPI_ CE0 SPI-CS 
GND 一 全 | scN62 SPWMO 上 所 PL8 


b. 然后 在 bootorangepiEnv.txt 中 设置 overlays=uart3 就 可 以 打开 uart3 的 配置 
overlays=uart3 
c. 然后 重启 系统 ， 启 动 时 ， 在 u-boot 的 启动 log 中 可 以 看 到 UART 相关 的 DT 
overlays 的 配置 输出 
Applying kernel provided DT overlay sunS0i-h6-uart3.dtbo 
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208 bytes read in 4 ms (0S.4 KiB/S) 

IApplying kernel provided DT fixup script (Sun50i-h6-fixup.scT) 

d， 系统 启动 后 ， 在 /sys/class/tty 下 可 以 看 到 ttyS3 的 信息 ，26pin 中 的 uart3 对 
应 /dewttyS3 


:-# LS /SYS/CLass/tty/ttySkx -Lh 
Lrwxrwxrwx 1 root root 0 Jan 1 1970 
root root 6 Dec 


root root 6 Jan 


root root 0 Dec 
root root 0 Jan 
root root 0 Jan 
root root 0 Jan 
Lrwxrwxrwx 1 root root 0 Jan 


VVVVIVIVYVYV 


2) 然后 开始 测试 uart 接口 ， 先 使 用 杜邦 线 短 接 要 测试 的 uart3 接口 的 rx 和 多 


uart3 
ft 引 脚 对 应 13 号 引 脚 
rx 引 脚 对 应 11 号 引 脚 


3) 然后 修改 wiringOP 中 串口 测试 程序 serialTest 打开 的 串口 设备 节点 名 为 /dewttyS3 


rootOorangepl3:~/wiringOP/examples# vim serialTestc 


int malin () 


TREE ， 


lnt Count ; 
unsigned int nextTime ; 


if ((fd = seriatopen (人 


fprintf ( s%sNn"，Sstrerror (errno)) ; 


} 


玫 


4) 再 编译 wiringOP 中 的 串口 测试 程序 serialTest 
root(Oorangepi:~/wiringOP/examples# make SerialTest 
[CC] serialTest.c 

[link 


rootOorangepi:~/wiringOP/examples# 


$) 最 后 运行 serialTest， 如 果 能 看 到 下 面 的 打印 ， 说 明 串 口 通信 正常 


root(Oorangepli:~/wiringOP/examples# ./SserialTest 


Onut: 0: -> 0 
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Out: 1 -> 1 
Oils 2 
Out: 3 -> 3 
out: 4: -> 4 
Out: 3: -> 5 
Out: 060: -> 0 
全 US 
Out: 8 -> 82C 


3. 30. I2C 接口 的 0.96 寸 OLED 模块 使 用 方法 


1) 香 橙 派 的 0.96 寸 OLED 模块 如 下 图 所 示 ， 其 7 位 的 ic 从 机 地 址 为 0x3c 


人 rande Pi 


多 /0.96 inch OLED module 


2) 先 将 0.96 寸 OLED 模块 通过 杜邦 线 连接 到 Orange Pi 开发 板 的 26pin 接口 上 ， 接 
线 方式 如 下 所 示 


OLED 模块 的 引 脚 描述 开发 板 26pin 接口 对 应 引 脚 

GND 电源 地 6 号 引 脚 
VCC SV 2 号 引 脚 

SCL IC 时 钟 线 S 号 引 脚 

SDA IC 数据 线 3 号 引 脚 

RST 接 3.3V 1 号 引 脚 

DC 接 GND 9 号 引 脚 

CS 接 GND 25 号 引 脚 
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-irongepi VE 


DC 7 一 


504 = 人 国 


| 


3) 将 OLED 模块 连接 到 开发 板 后 , 先 使 用 ic-tools 工具 检查 下 是 否 能 扫描 到 OLED 
模块 的 地 址 
rootOorangepi:~##aptupdate 


rootOorangepi~##apt install i2c-tools 
root(Oorangepi:~##i2cdetect -y0 


## 12Ccdetect -Y 0 
| 


4) 然后 就 可 以 使 用 wiringOP 中 的 oled_demo 来 测试 OLED 模块 ， 测 试 步骤 如 下 所 
示 
root(Oorangepi:~ 和 # git clone https://github.com/orangepi-xunlong/wiringOP 


root(Oorangepi:~##cd wiringOP 
rootOorangepi~/wiringOP# build clean && .build 
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rootOorangepi~/wiringOP# cd examples 
rootOorangepi~/wiringOP/examples# make oled_demo 
rootOorangepi~/wiringOP/examples# .oled_demo /dewi2c-0 


5) 运行 oled_demo 后 ， 在 OLED 屏幕 上 就 能 看 到 下 面 的 输出 


SS SS SS SN SSSSSSSSSS 
3. 31. SPI LCD 显示 屏 使 用 方法 
注意 ， 此 方法 只 适用 于 linux4.9 内 核 的 系统 ，linuxs.4 内 核 的 系统 无 法 使 用 


3. 31. 1 2.4 寸 SPILCD 显示 屏 


1) 测试 的 LCD 显示 屏 详情 页 链接 如 下 
http:/www.lcdwiki.com/2.4inch SPI Module ILI9341 SKEU:MSP2402 


2) LCD 显示 屏 和 开发 板 的 接线 方式 如 下 所 示 


TFT SPI 模块 引 脚 开发 板 26pin 对 应 的 引 脚 GPIO -- GPIO num 
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VCC 1 号 引 脚 
GND 6 号 引 脚 
CS 24 号 引 脚 
RESET 12 号 引 脚 PD18 -- 114 
D/C 16 号 引 脚 PD15 -- 111 
SDIIMOSD 19 号 引 脚 
SCK 23 号 引 脚 
LED 18 号 引 脚 PD16 -- 112 
SDO(MISO) 21 引 脚 


3) 将 显示 屏 接 到 开发 板 后 ， 再 使 用 下 面 的 命令 加 载 ptftt_device 内 核 模块 


rootOorangepi:~# modprobe fbtft_ device custom name=fb 讶 9341 busnum=L1 cs=( 
gpios=reset:114,dc:111,led:112 rotate=90 Speed=0S000000 bgr=1 txbuflen=0SS30 


4) fbtft_device 内 核 模块 加 载 时 dmesg 命令 正确 的 输出 log 如 下 所 示 , 而 且 由 log 可 
以 知道 LCD 显示 屏 使 用 的 framebuffer 为 fb8 


root(Oorangepi:~##dmesg | tail 


191.788887] splidev spil1.0: dh2228fv splil1.0 1200kHz 8 bits mode=0x00 


191.789343] splidev spil.0: Deleting spil.0 


191.793283] fbtft device: GPIOS used by 'fb ili9341": 


191.793313] fbtft_ device: "dc' = CPIO111 
191.793324] fbtft_ device: "led' = CPIO112 


191.793351] spli spl1.0: fb ili9341 spl1.0 63000kHz 8 bits mode=0x00 


[ 
[ 
[ 
[ 191.793301] fbtft_ device: 'reset = GPIO114 
[ 
[ 
[ 
[ 


191.807788] fb 1li9341: module ls from the staging directory, the quality ls unknownj 


you have been warned. 


[ 192.083355] graphics fb8: fb 1li9341 frame buffer, 320x240, 150 KIB video memoryj 


64 KiIB buffer memory, fps=20, spil.0 at 63 MHz 


$) 然后 使 用 下 面 的 命令 就 可 以 在 LCD 显示 屏 上 显示 Orange Pi 的 logo 图 片 


rootOorangepi:~##apt update 
rootOorangepi:~#apt -y install fbi 


root(Oorangepi:~#fbi-vt1-noverbose -d /dev/fb8 /boot/boot.bmp 
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6) 还 可 以 将 ttyl 的 输出 映射 到 LCD 显示 屏 的 包 设备 一 一 名 8， 有 映射 完 后 ，HDMI 
就 不 会 再 有 图 像 输出 了 
root(Oorangepi~##con2fbmap 18 


如 果 要 切换 回 HDMI 显示 ， 请 使 用 下 面 的 命令 
root(Oorangepi:~##con2fbmap 10 


下 面 是 运行 htop 命令 的 输出 


,中 
9.8 


间 驯 百 己 忆 
aaoocse9s 


二 
1 
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7) 由 于 默认 的 终端 字体 太 大 ， 导 致 显示 屏 无 法 显示 太 多 的 内 容 ， 可 以 通过 下 面 的 方 
法 来 缩小 终端 的 字体 
a 首先 运行 dpKg-reconfigure console-setup 


root(Oorangepi:~##apt-get update 

rootOorangepi:~##apt-get install kbd 

root(Oorangepi:~##dpkg-reconfigure console-setup 
b， 终端 编码 选择 UTEF-8 


VISCII 


<0Kk> <CanceL> 


c. 然后 选择 Guess optimal character set 


.Combined - Latin; StLavic CyriLLic; Greek 
.Combined - Latin; SLavic and non-SLavic CyriLLic 


Guess optimatL character set 


<0k> <CanceL> 


d.， 然后 选择 Terminus 


Fixed 
Goha 
GohaCLassic 


Termlnus 
TerminusBoLd 
TerminusBoLdVGA 


VGA 
Do not change the boot/kernetL font 
Let the System selLect a SuitabtLe font 


<0k> <CancelL> 


e. 最 后 选择 字体 大 小 为 6x12 
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(framebuffer ontLy ) 
8Xx14 


8Xx16 

10x20 (framebuffer onLy) 
11x22 (framebuffer onLy) 
12Xx24 (framebuffer onLy) 
14x28 (framebuffer ontLy) 
16x32 (framebuffer ontLy) 


<0k> <CanceL> 


f 设置 完 后 就 能 看 到 LCD 显示 屏 上 的 字体 变 小 了 


8) 设置 系统 启动 自动 加 载 fbtft_device 模块 的 方法 
a 新 建 /ete/modules-load.d/fbtfteon 配置 文件 ， 文 件 内 容 如 下 所 示 
rootorangepi:~#ecat /etc/modules-load.d/fbtftconf 
fbtft _ device 
b. 新 建 /etwmodprobe.d/fbtft.conf 配置 文件 ， 文 件 内 容 如 下 所 示 
rootOorangepi:~# cat /etc/modprobe.d/fbtft.conf 


options fbttt _ device custom name=fb ili9341 busnum=1l cs=0 
spios=reset:114,dc:111,led:112 rotate=90 speed=65000000 bgr=1l txbuflen=63530 
c. 然后 重启 linux 系统 就 能 看 到 fbtft_device 相关 的 内 核 模 块 都 已 自动 加 载 


9) 如 果 和 希望 linux 系统 启动 后 自动 将 console 映射 到 LCD 显示 屏 ， 请 在 
/bootorangepiEnv.txt 中 加 入 下 面 的 配置 ， 然 后 重启 系统 就 能 看 到 LCD 显示 屏 有 和 输 
出 了 

rootOorangepi:~#cat /boot/orangepiEnv.txt | grep "fbcony" 


extraargs=cma=2SM fbcon=map:8 


3. 31. 2. 3.2 寸 RPi SPI LCD 显示 屏 


1) 测试 的 LCD 显示 屏 详情 页 链接 如 下 
http:/www.lcdwiki.com/3.2inch RPI Display 


2) LCD 显示 屏 和 开发 板 接线 方式 如 下 所 示 
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3) 将 LCD 显示 屏 接 到 开发 板 后 ， 再 使 用 下 面 的 命令 加 载 ptft_device 内 核 模 块 
rootOorangepi~## modprobe fbtft_ device custom name=fb 订 i9341 busnum=1 cs=( 
cpios=reset:119,dc:302 rotate=90 Speed=0S000000 bgr=1l txbuflen=0SS30 


4) fbtft_device 内 核 模 块 加 载 时 dmesg 命令 正确 的 输出 log 如 下 所 示 , 而 且 由 log 可 
以 知道 LCD 屏幕 使 用 的 famebuffer 为 fb8 

rootOorangepi~##dmesg | taijl 

[ 97.884472] spldev spil1.0: dh2228fv spl1.0 1200kHz 8 bits mode=0x00 

[ 97.884933] spidev spi1.0: Deleting splil.0 

[ 97.888354] fbtft device: GPIOS used by "fb ili9341: 

[ 97.888373] fbtftt_ device: Teset = GPIO119 
[ 
[ 
[ 


97.888385] fbtftt device: "dc' = GPIO362 

97.889430] spli spil.0: fb ili9341 spil1.0 6S000KkHz 8 bits mode=0x00 

97.907191] tb ili9341: module is 位 om the staging directory, the quality 18 unknownj 
you have been warned. 
[ 98.181286] Console: switching to colour frame buffer device 40x30 
[ 98.181938] graphics fb8: 包 b lli9341 frame buffer 320x240, 1S0 KIB video memoryj 
64 KiIB buffer memory, fps=20, spil.0 at 63 MHz 


$) 然后 使 用 下 面 的 命令 就 可 以 在 LCD 屏幕 上 显示 Orange Pi 的 logo 图 片 
rootOorangepi~##aptupdate 


rootOorangepi~##apt -y install fbi 


rootOorangepi~##fbi-vtl1-noverbose -d /dev/fb8 /bootboot.bmp 


Www.oOrangepl.cn 90 WwWw.Xunlong.tv 


艺 range Pi 用 户 手册 深圳 市 迅 龙 软 件 有 限 公 司 版 权 所 有 


anqe Pi 


initializing boot loader 


6) 还 可 以 将 ttyl 的 输出 映射 到 LCD 屏幕 的 印 设备 一 一 了 8， 映射 完 后 , HDMI 就 不 
会 再 有 图 像 输出 了 
root(Oorangepi:~##con2fbmap 18 


如 果 要 切换 回 HDMI 显示 ， 请 使 用 下 面 的 命令 
rootOorangepi~##con2fbmap 10 
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种 驯 台 牟 马 马 
症 二 加 瑟 辐 台 忆 TH 


1 
-中 CI 


7) 由 于 默认 的 终端 字体 太 大 ， 导 致 屏幕 无 法 显示 太 多 的 内 容 ， 可 以 通过 下 面 的 方法 
来 缩小 终端 的 字体 

a 首先 运行 dpKg-reconfigure console-setup 
root(Oorangepi:~##apt-get update 
rootOorangepi~##apt-get install kbd 


root(Oorangepi:~##dpkg-reconfigure console-setup 
b， 终端 编码 选择 UTF-8 


K0I8-U 
TIS-620 


UTF-8 


VISCII 


<0k> <CanceL> 


c. 然后 选择 Guess optimal character set 


。Combined - Latin; SLavic CyriLLic; Greek 
。Combined - Latin; SLavic and non-SLavic CyriLLic 


<0k> <CanceL> 


d.， 然 后 选择 Terminus 
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Fixed 
Goha 
GohaCLassic 


Termlnus 
TerminusBoLd 
TerminusBoLdVGA 


VOA 
Do not change the boot/kernetL font 
Let the System selLect a SuitabtLe font 


<0k> <CancelL> 


e. 最 后 选择 字体 大 小 为 6x12 


6x1l12 (framebuffer onLy ) 
8Xx14 


8x16 

1I0x20 (framebuffer onLy) 
11x22 (framebuffer onLy) 
12Xx24 (framebuffer onLy) 
14x28 (framebuffer onLy) 
16x32 (framebuffer onLy) 


<0Kk> <CanceL> 


f 设置 完 后 就 能 看 到 LCD 屏幕 上 的 字体 变 小 了 


8) 设置 系统 启动 自动 加 载 fbtft_device 模块 的 方法 

a 新 建 /etwmodules-load.d/fbtftcon 配置 文件 ， 文 件 内 容 如 下 所 示 
rootOorangepi:~#ecat /etc/modules-load.d/fbtftconf 
fbtft_ device 

b. 新 建 /etwmodprobe.d/fbtft.conf 配置 文件 ， 文 件 内 容 如 下 所 示 
root(Oorangepi:~## cat /etc/modprobe.d/fbtft.conf 


options fpbt 蔚 device custom name=fb ili9341 busnum=1l cs=0 gplios=reset:119,dc:362 
rotate=90 Speed=05000000 bgr=1l txbuflen=6063330 
c.， 然后 重启 linux 系统 就 能 看 到 fbtft_device 相关 的 内 核 模 块 都 已 自动 加 载 


9) 如 果 和 希望 linux 系统 启动 后 自动 将 console 映射 到 LCD 屏幕 ， 请 在 
/bootorangepiEnv.txt 中 加 入 下 面 的 配置 ， 然 后 重启 系统 就 能 看 到 LCD 屏幕 有 输出 
且 

rootOorangepi:~#cat /boot/orangepiEnv.txt | grep "fbcony" 


Www.oOrangepl.cn 99 WwWw.Xunlong.tv 


马 range Pi 用 户 手 册 深圳 市 迅 龙 软件 有 限 公 司 版 权 所 有 


extraargs=cma=2SM fbcon=map:8 


3.31.3. 3.5 寸 SPILCD 显示 屏 


1) 测试 的 LCD 显示 屏 详情 页 链接 如 下 
http:/www.lcdwiki.com/3.Sinch SPI Module ILI9488 SKU:MSP35320 


2) LCD 显示 屏 和 开发 板 的 接线 方式 如 下 所 示 


TFT SPI 模块 引 脚 开发 板 26pin 对 应 的 引 脚 GPIO -- GPIO num 
VCC 1 号 引 脚 
GND 6 号 引 脚 
CS 24 号 引 脚 
RESET 12 号 引 脚 PD18 -- 114 
DC/RS 16 号 引 脚 PD15 -- 111 
SDI(IMOSD 19 号 引 脚 
SCK 23 号 引 脚 
LED 18 号 引 脚 PD16 -- 112 
SDO(MISO) 21 引 脚 


3) 将 显示 屏 接 到 开发 板 后 ， 再 使 用 下 面 的 命令 加 载 btft_device 内 核 模 块 
rootOorangepi:~# mmodprobe fbtft_ device custom name=fb 讶 9488 busnum=T1 cs=( 
cpios=reset:114,dc:111led:112 rotate=270 speed=0S000000 bgr=l txbuflen=0SS30 


4) fbtft_device 内 核 模块 加 载 时 dmesg 命令 正确 的 输出 log 如 下 所 示 , 而 且 由 log 可 
以 知道 LCD 显示 屏 使 用 的 framebuffer 为 fb8 

rootOorangepi:~##dmesg | tail 

30.897230] splidev spl1.0: dh2228fv spil.0 1200kHz 8 bits mode=0x00 
30.897709] splidev spil1.0: Deleting spil.0 

30.900560] fbttt _ device: GPIOS used by 了 bp ili9488': 

30.900379] fbtftt_ device: reset = GPIO114 

30.900591] fbttt _ device: 'dc' = GPIO111 

30.900602] fbttt device: led = GPIO112 

306.900629] spi spil.0: fp ili9488 spil1.0 6S000KkHz 8 bits mode=0x00 
30.918499] tb lli9488: module is fom the staging directory, the quality 18 unknownj 


you have been warned. 


[ 
[ 
[ 
[ 
[ 
[ 
[ 
[ 
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[ 37.263271] graphics fb8: b lli9488 frame buffer 480x320, 300 KIB video memoryj 
6064 KIB buffer memory, fps=60, spll1.0 at 6 MHz 


$) 然后 使 用 下 面 的 命令 就 可 以 在 LCD 显示 屏 上 显示 Orange Pi 的 logo 图 片 
root(Oorangepi:~##aptupdate 


rootOorangepi~##apt -y install fbi 
rootOorangepi:~##fbi-vtl1-noverbose -d /dev/fb8 /boot/boot.bmp 


SSSSSSEESSSS ss - < Eee ss 


initializing boot loader 


TECN 


6) 还 可 以 将 ttyl 的 输出 映射 到 LCD 显示 屏 的 名 设备 一 一 好 8， 映 射 完 后 ，LCD 屏 
幕 将 会 显示 终端 的 输出 ，HDMI 就 不 会 再 有 图 像 输 出 了 
root(Oorangepi:~##con2fbmap 18 


如 果 要 切换 回 HDMI 显示 ， 请 使 用 下 面 的 命令 
rootOorangepi~##con2fbmap 10 
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1 / 1 
1 人 


A Ar - 


外 


肪 , 


orangepi3 logim: roct 
Passwuora: 


二 CA 
OA 


N 2 1_1 


Uelcome to Focal with Li 
Zz.69 0.99 0.34 ”Up tine: 


Sustem load : 3 1972MB IP; 


WemorJ usage: 

CPU temp: 

: 8Bx of 156 

Usage of /: 8Bx Di 人 
3 0Z9 from 192.168. | 

im: 8 93:35:96 UTC 2 
Last login: Tuc Dec 
mW pts/9 


rooteorangepi32 委 芭 


7) 设置 系统 启动 自动 加 载 fbtft_device 模块 的 方法 

a 新 建 /etwmodules-load.d/fbtftcon 配置 文件 ， 文 件 内 容 如 下 所 示 
root(Oorangepi:~ 和 ## cat /etc/modules-load.d/fbtft.conf 
fbtft_ device 

b. 新 建 /etwmodprobe.d/fbtft.conf 配置 文件 ， 文 件 内 容 如 下 所 示 
root(Oorangepi:~ 和 ## cat /etc/modprobe.d/fbtft.conf 


options fbtftt_ device custom name=fb 1ili9488 ”busnum=1l cs=0 
gplos=reset:114,dc:111,led:112 rotate=270 Speed=063000000 bgr=1l txbuflen=63536 
c.， 然后 重启 linux 系统 就 能 看 到 fbtft_device 相关 的 内 核 模 块 都 已 自动 加 载 


8) 如 果 和 希望 lnux 系统 启动 后 自动 将 console 映射 到 LCD 显示 屏 ， 请 在 
/bootorangepiEnv.txt 中 加 入 下 面 的 配置 ， 然 后 重启 系统 就 能 看 到 LCD 显示 屏 有 和 输 
出 了 

root(Oorangepi:~ 和 cat /boot/orangepiEnv.txt | grep "fbcony 


extraargs=cma=2SM fbcon=map:8 


9) 如 果 需 要 将 桌面 版 系统 显示 到 ICD 屏幕 ， 可 以 执行 下 面 的 命令 ， 等 待 几 秒 钟 后 ， 
LCD 屏幕 就 能 看 到 linux 系统 的 桌面 了 
root(Oorangepi:~ 直 RAMEBUFFER=/dev/fb8 startx 
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10) 如 果 希 望 lnux 系统 启动 后 自动 将 桌面 显示 到 LCD 显示 屏 , 请 在 linux 系统 中 添 
加 下 面 的 配置 文件 ， 然 后 重启 系统 就 能 看 到 LCD 显示 屏 有 显示 输出 了 
rootOorangepi~##cat /usr/share/ 和 11/xorg.conf.d/99-fbdev.conf 


Sectton "Devicey" 
Identifier "myfb" 


Www.orangepl.cn 103 Www.xunlong.tv 


艺 range Pi 用 户 手册 深圳 市 迅 龙 软件 有 限 公司 版 权 所 有 


Driver "fbdev" 
Option "fbdev"” "dev/fbg8" 
EndSsection 


3. 32. 将 内 核 打 印信 息 输 出 到 26pin 串口 的 方法 


内 核 console 默认 输出 到 ttyS0， 也 融 是 开发 板 上 的 3pin 调试 串口 。 我 们 也 可 以 
设置 内 核 console 输出 重 定向 到 26pin 接口 中 的 UART3， 方 法 如 下 : 


1) linux5.4 系统 需要 先 将 uart3 的 配置 打开 ,详细 的 配置 方法 见 26pin 的 UART 测 试 ， 
linux4.9 系统 默认 就 是 打开 的 ， 无 需 额外 的 配置 


2) 然后 修改 /bootboot'.cmd 中 的 console=ttyS0 为 console=ttyS3 


root@Oorangepi:~#vim /bootboot.cmd 


|| test = ;_ then setenv consoLeargs 
0、 


; then setenv consoLeargs 
; then setenv consoLeargs 


3) 然后 将 /booVboot.cmd 重新 编译 为 /bootVboot.scr〈 在 开发 板 的 linux 系统 中 操作 ) 


root(Oorangepi:~# mkimage -C none -A arm -Tscript -d /boot/boot.cmd /boot/boot.scr 


Image Name: 

Created: Tue Dec 8 02:33:43 2020 

Image Type: ARM Linux Script (uncompressed) 
Data Size: 2448 Bytes =2.39 KiB = 0.00 MiB 
Load Address: 00000000 

Entry Point: 00000000 

Contents: 


Image 0: 2440 Bytes = 2.38 KiIB = 0.00 MiB 


4) 然后 将 USB 转 TTL 模块 通过 杜邦 线 接 到 26pin 接口 的 UART3 引 脚 上 
a USB 转 TIL 模块 的 GND 接 到 开发 板 26pin 接口 的 GND 上 
b，USB 转 TTL 模块 的 RX 接 到 开发 板 UART3 的 TX 上 
c USB 转 TTL 模块 的 TX 接 到 开发 板 UART3 的 RX 上 
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$) 然后 重启 开发 板 ， 可 以 看 到 内 核 console 默认 输出 到 了 ttyS3 。 注 意 此 时 uboot 


的 输出 log 还 是 输出 到 ttyS0， 不 会 输出 到 ttyS3 


0range P1I 2.1.0 Buster ttyS3 


orangep1l3 Logilin: 


3. 33. 硬件 看 门 狗 测 试 


1D) 下 载 wiringOP 的 代码 


rootOorangepi~##aptupdate 
rootOorangepi~##apt install git 


root(Oorangepi:~ 和 # git clone https://github.com/orangepi-xunlong/wiringOP 


2) 编译 watchdog 测试 程序 


rootOorangepi~##cd wiringOP/examples/ 


root(Oorangepi:~/wiringOP/examples# gcc watchdog.c -0 watchdog 


3) 运行 看 门 狗 测试 程序 


a. 第 二 个 参数 10 表示 看 门 狗 的 计数 时 间 ， 如 果 这 个 时 间 内 没有 喂 狗 ， 系 统 会 


重 局 


b， 我 们 可 以 通过 按 下 键盘 上 的 任意 键 〈ESC 除外 ) 来 喂 狗 ， 喂 狗 后 ， 程 序 会 


打印 一 行 keep alive 表示 咀 狗 成 功 


rootOorangepi~/wiringOP/examples# ./watchdog 10 


OPben SUCCeSS 
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options 1s 331S2,identity ls Sunxi-wdt 
Iput _ usr return, 让 0,success:0 

The old reset time 1S: 16 

return ENOTTY, 计 -1,sSuccess:0 
return ENOTTY,if -1,sSuccess:0 

Iput user return,if 0,sSuccess:0 

Iput _ usr Teturn, 寺 0,success:0 

keep alive 


keep alive 


keep alive 


3. 34. 查看 H6 芯片 的 chipid 


注意 ， 此 方法 只 适用 于 linux4.9 系统 


1]) 查看 h6 芯片 chipid 的 命令 如 下 所 示 ， 每 个 必 片 的 chipid 都 是 不 同 的 ， 所 以 可 以 
使 用 chipid 来 区 分 多 个 开发 板 

rootOorangepi:~#cat /Sys/class/sunxi info/sys_info | grep "chipidy， 

Sunxl_chipid :38641f0fD141410900004c0000000000 


3. 35. 烧 写 linux 镜像 到 eaMMSC 的 方法 


1) 烧 录 linux 镜像 到 eMMC 中 需要 借助 TF 卡 来 完成 ， 首 先 将 linux 镜像 烧 录 到 TF 
卡 上 ， 然 后 局 动 开 发 板 进 入 linux 系统 


2) 然后 运行 nand-sata-install 脚本 


rootOorangepi:~#nand-sata-install 


3) 然后 选择 2 Boot from eMMC - sysytem on eMMC 
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Choose an option: 


Current root: UUID=2b84c970-6860-4343-8cc0-b5909bclce6d5 


Boot from eMMC - System on eMMC 
5 InstaLL/Update the bootLoader on SD/eMMC 


<Cancet> 


4) 然后 会 弹出 一 个 警告 ， 脚 本 将 会 擦 除 eMMC 上 的 所 有 数据 ， 选 择 <Yes> 继 续 
eMMC instalLL 


This script WiLL erase your eMMC. Continuey? 


< Mo > 


$) 然后 会 提示 选择 文件 系统 的 类 型 ， 支 持 ext2/3/4、 仑 全 以 及 btrfs 五 种 文件 系统 
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SeLect fiLesystem type for eMMC /dev/mmcbLk1 


| 国 ext4 


之 1eX3 
引 ext2 
4 2fs 


<Cancet> 


SeLect fiLesystem type for eMMC /dev/mmcbLk1 
Rs) 


2 
3 
二 
目 


<Cancet> 


6) 然后 会 开始 格式 化 seMMC ,格式 化 完 eMMSC 后 就 会 开始 烧 录 linux 镜像 到 eMMC 
中 


eMMC InstaLL 


Transferring rootfs to /dev/mmcbLklp1 (1276 MB) . 


This wiLL take approximatetLy 4 minutes to finish. PLease Waitl 


w， 


7) 烧 录 完 后 会 提示 下 面 的 选项 ， 可 以 选择 <Power off> 直接 关 机 
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eMMC lnstalLL 


ALL done. Power off 


8) 然后 拔 出 TF 卡 ， 再 重新 上 电 ， 就 会 司 动 aeMMC 中 的 linux 系统 了 


3. 36. 开机 和 关机 方法 


1) 使 用 poweroff 命令 关机 


root(Oorangepi:~#powero 仁 


2) 还 可 以 短 按 开 发 板 上 的 电源 按键 来 关机 


4) 重启 linux 系统 的 命令 为 


root(Oorangepli:~##Treboot 
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4. Linux SDK 使 用 说 明 


Linux SDK 的 编译 都 是 在 安装 有 Ubuntu 18.04 的 PC 或 者 虚拟 机 〈VirtualBox 
或 VMware) 上 进行 的 , 请 不 要 使 用 其 他 版 本 的 Ubuntu 系统 或 者 在 WSL 上 编译 Linux 
SD 开 


4.1. 获取 1linux sdk 的 源码 


4.1.1. 从 github 下 载 orangepi-build 


1) 首先 下 载 orangepi-build 的 代码 ，orangepi-build 的 代码 是 基于 armbian build 编译 
系统 修改 而 来 的 ， 目 前 H6 系列 开发 板 已 经 支持 legacy 分 文 和 current 分 文 
testtest:~$ sudo apt update 


testtest:~$ sudo apt install git 
testtest:~$ git clone https://github.com/orangepi-xunlong/orangepi-build.git 


2) legacy 分 支 一 般 使 用 BSP 版 本 的 u-boot 和 内 核 ，current 分 支 一 般 使 用 接近 主线 
版 本 的 u-boot 和 内 核 ，H6 系列 开发 板 当前 使 用 的 u-boot 和 linux 内 核 如 下 所 示 


分 支 u-boot 版 本 linux 内 核 版 本 
legacy U-boot 2014.07 linux4.9.118 
cuIrent U-boot 2020.04 linux5.4.64 


3) orangepi-build 下 载 完 后 会 包含 下 面 的 文件 和 文件 夹 
a、 build.sh: 编译 启动 脚本 
b.， external: 包含 编译 镜像 需要 用 的 配置 文件 、 特 定 的 脚本 以 及 部 分 程序 的 源 
码 等 
c LICENSE: GPL 2 许可 证 文件 
d.， README. md: orangepi-build 说 明文 件 
ce， Scripts: 编译 linux 镜像 的 通用 脚本 
testtest:~/orangepi-buildy ls 
build.sh external LICENSE README. md scripts 
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4. 1.2.， 下载 交叉 编译 工具 链 


1) orangepi-build 第 一 次 运行 的 时 候 会 自动 下 载 交 叉 编 译 工具 链 放 在 toolchains 文件 
夹 中 ， 每 次 运行 orangepi-build 的 build.sh 脚本 后 ， 都 会 检查 toolchains 中 的 交叉 编 
译 工 具 链 是 否 都 存在 ， 如 果 不 存在 则 会 重新 开始 下 载 ， 如 果 存 在 则 直接 使 用 ， 不 会 
重复 下 载 


] Checking for external 6CC compiters 
] downLoading using http(s) network [ 
#8d7029 16MiB/24MiB CN:1 DL: ETA: 
] verified [ ] 
] decompressing 
.，] gcc-Linaro-aarch64-none-eLf-4.8-2013.11 Linux.tar.xz: 24.9MiB [14.4MiB/s] [一 = 
] downtLoading using http(s) network [ 
#e3geec 17MiB/33MiB CN:1 DL: ETA: 
] Verified [ 
] decompressing 
.， ] gcc-Linaro-arm-none-eabi-4.8-2914.04 Linux.tar.xz: 33.9MiB [9.66MiB/s] [===: ====>] 100% 
] downLoading using http(s) network [ 
#@41c24 48MiB/48MiB CN:1 DL: 
] verified [ ] 
] decompressing 
.，] gcc-Linaro-arm-Linux-gnueabihf-4.8-2014.64 Linux.tar.xz: 48.8MiB [13.0MiB/s] [===: 
] downtLoading using http(s) network [ 
#3dee3e 72MiB/76MiB CN:1 DL: ETA: 
] Verified [ 
] decompressing 


.，] gcc-Linaro-4.9.4-2017.01-x86 64 arm-Linux-gnueabi.tar.xz: 77.9MiB [14.2MiB/S] [=====: ====>] 100% 
] downtLoading using http(s) network [ 
#42e728 194MiB/104MiB CN:1 DL: 
] Verified [ ] 


] decompressing 
.，] gcc-Linaro-7.4.1-2019.02-x86 64 arm-Linux-gnueabi.tar.xz: 
] downLoading using http(s) network [ 
#2C965e 108MiB/111MiB CN:1 DL: 
] Verified [ 
] decompressing 
.，] gcc-Linaro-7.4.1-2019.02-x86 64 aarch64-Linux-gnu.tar.xz: 111MiB [13.4MiB/s] [ ====>]】 106% 
] downLoading using http(s) network [ 
#d232ee 259MiB/251MiB CN:1 DL: 
] verified [ ] 
] decompressing 
.，] gcc-arm-9.2-2919.12-x86 64-arm-none-Linux-gnueabihf.tar.Xxz: 251MiB [13.7MiB/s] [ 
] downLoading using http(s) network [ 
#88b441 268MiB/269MiB CN:1 DL: 
] Verified [ ] 
g 


2) 交叉 编译 工具 链 在 中 国境 内 的 镜像 网 址 为 清华 大 学 的 开源 软件 镜像 站 


https:/mirrors.tuna.tsinghua.edu.cn/armbian-releases/_ toolchainy/ 


3) toolchains 下 载 完 后 会 包含 多 个 版 本 的 交叉 编译 工具 链 
testtest:~/orangepi-build$ ls toolchains/ 


gcc-arm-9.2-2019.12-x86 64-aarch64-none-linux-gnu 
gcc-linaro-7.4.1-2019.02-x86 64 arm-linux-gnueabli 
gcc-arm-9.2-2019.12-x86 64-arm-none-linux-gnueabiht 
gcc-linaro-aarch64-none-elf-4.8-2013.11 linux 
gcc-linaro-4.9.4-2017.01-x86 64 arm-linux-gnueabli 
gcc-linaro-arm-linux-gnueabihf-4.8-2014.04 linux 
gcc-linaro-7.4.1-2019.02-x86 64 aarch064-linux-gnu 


gcc-linaro-arm-none-eabi-4.8-2014.04 linux 


4) 编译 H6 linux 内 核 源 码 使 用 的 交叉 编译 工具 链 为 


a. lnux4.9 
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gcc-arm-9.2-2019.12-x86 64-aarch64-none-linux-gnu 
b.， linux5.4 
gcc-arm-9.2-2019.12-x86 64-aarch64-none-linux-gnu 


5) 编译 H6 u-boot 源码 使 用 的 交叉 编译 工具 链 为 
auU-boot 2014.07 

gcc-linaro-4.9.4-2017.01-x86 64 arm-linux-gnueabli 
b.， u-boot 2020.04 

gcc-arm-9.2-2019.12-x86 64-aarch64-none-linux-gnu 


4.1.3. orangepi-build 完整 目录 结构 说 明 


1) orangepi-build 仓库 下 载 完 后 并 不 包含 linux 内 核 、u-boot 的 源码 以 及 交叉 编译 工 
具 链 ，linux 内 核 和 u-boot 的 源码 存放 在 独立 的 git 仓库 中 〈 请 不 要 单独 下 载 使 用 内 
核 和 u-boot 的 源码 进行 编译 操作 ， 除 非 你 知道 怎么 用 ) 
alinux 内 核 源码 存放 的 git 仓库 如 下 ， 其 中 sun50iw6 为 H6 SOC 世 片 代号 
al) lnux4.9 
https:/github.comy/orangepi-xunlong/linux-orangepitree/orange-pl-4.9-Sun30iw6 
b) linux53.4 
https:/github.comy/orangepi-xunlong/linux-orangepltree/orange-pl-3.4 
b.， u-boot 源码 存放 的 git 仓库 如 下 ， 其 中 sunS0iw6 为 H6 SOC 臣 片 代号 
a) uU-boot 2014.07 
https:/github.comy/orangepi-xunlong/u-boot-orangepUtree/v2014.07-sSun30iw6-linux4.9 
b) u-boot 2020.04 
https:/github.comy/orangepi-xunlong/u-boot-orangepltree/v2020.04 


2) orangepi-build 第 一 次 运行 的 时 候 会 去 下 载 交 叉 编 译 工 具 链 、u-boot 和 linux 内 核 
源码 ， 成 功 编译 完 一 次 linux 镜像 后 在 orangepi-build 中 可 以 看 到 的 文件 和 文件 夹 有 
a build.sh: 编译 启动 脚本 
b.， external: 包含 编译 镜像 需要 用 的 配置 文件 、 特 定 功能 的 脚本 以 及 部 分 程序 
的 源码 ， 编 译 镜 像 过 程 中 缓存 的 rootf 压缩 包 也 存放 在 external 中 
c. kernel: 存放 linux 内 核 的 源码 ， 里 面 名 为 orange-pi-4.9-sunSgiw6 的 文件 夹 
存放 的 就 是 H6 开发 板 legacy 分 文 的 内 核 源 码 , 里 面 名 为 orange-pi-S$.4 的 文 
件 夹 存放 的 就 是 H6 开发 板 current 分 文 的 内 核 源 码 《〈 如 果 只 编译 了 legacy 
分 支 的 linux 镜像 ， 那 么 则 只 能 看 到 legacy 分 支 的 内 核 源 码 ; 如 果 只 编译 了 
current 分 支 的 linux 镜像 ， 那 么 则 只 能 看 到 current 分 支 的 内 核 源码 ) ， 内 核 
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源码 的 文件 夹 的 名 字 请 不 要 手动 修改 ,如 果 修 改 了 编译 系统 运行 时 会 重新 下 
载 内 核 源 码 
d，LICENSE: GPL 2 许可 证 文件 
e.。 README.md: orangepi-build 说 明文 件 
f output: 存放 编译 生成 的 uboot、linux 等 deb 包 、 编 译 日 志 以 及 编译 生成 的 
镜像 等 文件 
g.， scripts: 编译 linux 镜像 的 通用 脚本 
h.， toolchains: 存放 交叉 编译 工具 链 
iu-boot: 存放 u-boot 的 源码 , 里 面 名 为 v2014.07-sunSgiw6-linux4.9 的 文件 夹 
存放 的 就 是 H6 开发 板 legacy 分 支 的 upoot 源码 ， 里 面 名 为 v2020.04 的 文 
件 夹 存放 的 就 是 H6 开发 板 current 分 支 的 u-boot 源码 (如 果 只 编译 了 legacy 
分 支 的 linux 镜像 ， 那 么 则 只 能 看 到 legacy 分 支 的 uboot 源码 ; 如 果 只 编译 
了 current 分 文 的 linux 镜像 ， 那 么 则 只 能 看 到 current 分 文 的 u-boot 源码 ) ， 
u-boot 源码 的 文件 夹 的 名 字 请 不 要 手动 修改 , 如 果 修 改 了 编译 系统 运行 时 会 
重新 下 载 uboot 源码 
j ， userpatches: 存放 编译 脚本 需要 用 到 的 配置 文件 
testtest:~/orangepi-buildy ls 
build.sh ”external kernel LICENSE output README.md scripts toolchaings 
u-boot userpatches 


4.1.4. 从 百度 云 盘 下 载 orangepi-build 


1) 如 果 从 github 下 载 orangepi-build 的 速度 很 慢 ， 还 可 以 从 百度 云 盘 下 载 
orangepi-build 的 压缩 包 ， 百 度 云 盘 的 下 载 链 接 为 

链接 : https:/pan.baidu.com/MlvWQmCmSYdH7iCDFYyKpJtVw 

提取 码 : zero 


ngepi-build 争 保 存 到 网 盘 
0 间 


天 昌 inu 错 信使 用 的 rootfs 绽 包 


2) 百度 云 盘 的 orangepi-build 文件 夹 下 有 两 个 文件 
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a orangepi-build.targz 为 orangepi-build 源码 的 压缩 包 
orangepi-build.tar.gz.mdSsum 为 orangepi-build 源码 的 压缩 包 的 MD5S 校 验 
和 文件 
c. 下 载 完 后 ， 请 首先 检查 下 orangepi-build.tar.gz 压缩 包 的 MD5S 校 验 和 是 否 正 
确 ， 这 样 可 以 防止 下 载 的 压 纵 包 有 问题 ， 如 果 不 正 确 ， 请 重新 下 载 ， 检 查 校 
验 和 是 否 正 确 的 命令 为 
testOtest:~$ mdssum -c orangepi-build.targz.mdSssum 


orangepi-build.tar.gz: 成 功 


返回 上 一 级 | 全 部 文件 ”orangepi-build - orangepi-build 


3) 然后 束 可 以 使 用 tar -zxf 命令 解压 orangepi-build.targz 
testtest:~$ tar -Zxf orangepi-buildq.tar.gz 

testtest:~$ cd orangepi-build/ 
testtest:~/orangepi-build$ ls 

build.sh 。 external “kernel LICENSE READMEE.mdqd scripts toolchainsg 
u-boot userpatches 


4) 使 用 orangepi-build 编译 系统 前 , 请 先 将 orangepi-build 和 github 服务 器 进行 同步 ， 
有 人保 代码 为 最 新 的 状态 
test(Otest:~/orangepi-build$y git pull 


| 


如 果 orangepi-build 和 github 服务 器 同步 过 程 有 问题 ， 可 以 尝试 下 面 的 方法 
testtest:~/orangepi-build$ sudo rm -rf external scripts 


testOtest:~/orangepi-build$ git checkout . 


testOtest:~/orangepi-build$y git pull 


$) 百度 云 盘 上 的 orangepi-build.targz 压缩 包 除 了 包含 orangepi-build 编译 系统 的 代 
码 外 ， 还 缓存 了 交叉 编译 工具 链 ，u-boot 和 linux 内 核 的 源码 。 所 以 在 编译 镜像 的 过 
程 中 就 不 会 去 github 服务 器 上 从 头 开 始 下 载 wboot 和 linux 内 核 的 源码 以 及 交叉 编 
译 工具 链 ， 这 样 可 以 节省 大 量 的 时 间 。orangepi-build 编译 系统 开始 运行 时 ， 默 认 会 
自动 从 github 同步 uboot 和 linux 内 核 的 源码 ， 以 确保 代码 为 最 新 状态 ， 所 以 无 需 
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手动 同步 u-boot 和 linux 内 核 的 源码 


6) 百度 云 盘 上 的 orangepi-build.tar.gz 解压 后 的 kernel 文件 夹 中 会 包含 多 个 版 本 的 
内 核 源 码 ， 请 不 要 修改 这 些 内 核 源 码 文件 夹 的 名 字 ， 否 则 会 导致 编译 系统 找 不 到 内 
核 源码 进而 重新 从 github 下 载 内 核 源 码 。kernel 文件 夹 下 的 多 个 内 核 源 码 并 非 都 能 
被 H6 系列 开发 板 使 用 ，H6 系列 开发 板 使 用 到 的 内 核 源 码 有 : 


orange-pi-4.9-sunSOiw6 H6 系列 开发 板 legacy 分 文 使 用 
orange-pi-5.4 H6 0 current 0 
etaHge-Pi49-SHHSObhw9 616- 和 开交 6 二 友 


7) 百度 云 盘 上 的 orangepi-build.targz 解压 后 的 u-boot 文件 夹 中 会 包含 多 个 版 本 的 
u-boot 源码 ， 请 不 要 修改 这 些 uboot 源码 文件 夹 的 名 字 ， 和 否则 会 导致 编译 系统 找 不 
到 u-boot 源码 进而 重新 从 github 下 载 u-boot 源码 。u-boot 文件 夹 下 的 多 个 版 本 的 
u-boot 源码 并 非 都 能 被 H6 系列 开发 板 使 用 , H6 系列 开发 板 使 用 到 的 uboot 源码 有 : 
v2014.07-sun50iw6-linux4.9 H6 系列 开发 板 legacy 分 支 使 用 
V2020.04 0 
2018.0S-sbHSOPw9 


4.2. 编译 u-boot 


1) 运行 build.sh 脚本 ， 记 得 加 sudo 权限 
test(Otest:~/orangepli-build$ sudo ./build.sh 


2) 选择 U-boot package， 然 后 回 车 


Choose an option 
CompitLe image | rootfs | kerneL | UuU-boot 


U-boot packad 
KerneL package 
Rootfs and alLtL deb packages 
FULL 05 image for flLashing 


3) 接着 选择 开发 板 的 型 号 
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Choose an option 


PLease choose a Board . 


orangepir1l ALLwinner H2+ quad core 256MB RAM WiFi SPI 2xETH 
orangepizero ALLwinner H2+ quad core 256MB/512MB RAM WiFi SPI 
orangepipc ALLwinner H3 quad core 1GB RAM 

orangepipcpLus ALLwinner H3 quad core 1GB RAM WiFi eMMC 
orangepione ALLwinner H3 quad core 512MB RAM 

orangepiLite ALLwinner H3 quad core 512MB RAM WiFi 
orangepipLus ALLwinner H3 quad core 1GB/2GB RAM WiFi GBE eMMC 
orangepipLus2e ALLwinner H3 quad core 2GB RAM WiFi GBE eMMC 
orangepizeropLus2h3 ALLwinner H3 quad core 512MB RAM WiFiVBT eMMC 
orangepipc2 ALLwinner H5 quad core 1GB RAM GBE SPI 
orangepiprime ALLwinner H5 quad core 2GB RAM GBE WiFiVBT 


orangepizeropLus ALLwinner H5 quad core 512MB RAM GBE WiFi SPI 
orangepizeropLus2h5 ALLwinner H5 quad core 512MB RAM WiFi/VBT eMMC 
3 H6 core 1GB/2GB RAM CBE WiFi/VBT eMMC USB3 


orangepiLite2 ALLwinner H6 quad core 1GB RAM WiFi/VBT USB3 
orangepionepLus ALLwinner H6 quad core 1GB RAM GBE 
orangepizero2 ALLwinner H616 quad core 512MB/1GB RAM WiFi/VBT GBE SPI 


4) 然后 选择 分 文 
a._current 会 编译 uboot v2020.04 
blegacy 会 编译 uboot v2014.07 


Choose an option 


SelLect the target kerneL branch 


current Recommended. Come with best Support 


egacy 0Ld stable Legal 


半 


$) 然后 就 会 开始 编译 uboot, 编译 时 提示 的 部 分 信息 说 明 如 下 (以 legacy 分 文 为 例 ) 
a U-boot 源码 的 版 本 


[ o.Kk. ] Complling u-boot [ v2014.07 ] 
b.， 交叉 编译 工具 链 的 版 本 
[ o.Kk. ] Compller verslon [ arm-linux-gnueabi-gcc 4.9.4 |] 
c.， 编译 生成 的 uboot deb 包 的 路 径 
[ o.Kk. ] Tarsget directory [ output/debs/u-boot | 
d.， 编译 生成 的 uboot deb 包 的 包 名 
[ ok. ] File name [ linux-u-bootr-legacy-orangepi3 2.1.0_ arm64.deb |] 
e. 编译 使 用 的 时 间 
[ok. ] Runtime[1min |] 
f 重复 编译 u-boot 的 命令 ， 使 用 下 面 的 命令 无 需 通过 图 形 界 面 选择 ， 可 以 直 
接 开 始 编译 uboot 
[ o.Kk. ] Repeat Build Options [ sudo .build.sh BOARD=orangepi3 BRANCH=legacy 
BUILD OPT=u-boot 下 ERNEL_ CONFIGURE=no ] 
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6) 查看 编译 生成 的 u-boot deb 包 
test(Otest:~/orangepli-build$y ls output/debs/u-boot/ 
linux-u-boot-legacy-orangepi3 2.1.0_ arm04.deb 


7) 生成 的 u-boot 的 deb 包 包 含 的 文件 如 下 所 示 

a. 使 用 下 面 的 命令 可 以 解压 deb 包 
testOtest:~/orangepi-build$ cd output/debs/u-boot 
test(Otest:~/orangepl_ build/output/debs/u-boot$ $ dpkg -XA、 
linux-u-boot-legacy-orangepi3 2.1.0_ arm64.deb . (注意 命令 最 后 有 个 “. 当 
test(Otest:~/orangepli _ build/output/debs/u-booty ls 
linux-u-boot-current-orangepli3 2.1.0_armhfdeb usr 

b.， 解压 后 的 文件 如 下 所 示 
test(Otest:~orangepli-build/output/debs/u-boot tree usr 


usT 
上 -一 tp 
上 一 linux-u-boot-legacy-orangepli3 2.1.0_arm04 
| “上 一 boot0_sdcard.fex /boot0 的 二 进 制 文件 
| “上 -一 boot package.fex /u-boot 的 二 进 制 文件 
上 -一 u-boot 
| 一 LICENSE 


FF 一 orangepl3-u-boot.dts 
[一 platform_ install.sh 


3 directories, 9 files 


8) orangepi-bulid 编译 系统 编译 u-boot 源码 时 首先 会 将 u-boot 的 源码 和 github 服务 
器 的 uboot 源码 进行 同步 ， 所 以 如 果 想 修改 u-boot 的 源码 ， 首 先 需要 关闭 源码 的 下 
载 更 新 功能 (需要 完整 编译 过 一 次 ur-boot 后 才能 关闭 这 个 功能 ,否则 会 提示 找 不 到 
u-boot 的 源码 ) ， 否 则 所 作 的 修改 都 会 被 还 原 ， 方 法 如 下 : 

设置 userpatches/config-default.conf 中 的 IGNORE UPDATES 变量 为 “yes?” 
test(Otest:~/orangepli-build$ vim userpatches/config-defaultconf 
IGNORE _ UPDATES="yes” 


9) 调试 uboot 代码 时 ， 可 以 使 用 下 面 的 方法 来 更 新 linux 镜像 中 的 u-boot 进行 测试 
a. 将 编译 好 的 uboot 的 deb 包 上 传 到 开发 板 的 linux 系统 中 
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test(Otest:~/orangepli-build$ cd output/debs/u-boot 
test(Otest:~/orangepl _ build/outputdebs/u-boot$ scp 、 
linux-u-boot-legacy-orangepi3 2.1.0 arm04.deb rootO192.108.1.xXXX:/root 
b. 然后 登录 到 开发 板 ， 彼 载 已 安装 的 uboot 的 deb 包 
root(Oorangepi:~##aptpurge -y linux-u-boot-orangepi3-legacy 
c. 再 安装 刚才 上 传 的 新 的 u-poot 的 deb 包 
root(Oorangepi:~ 坟 dpksg -ilinux-u-boot-legacy-orangepi3 2.1.0 arm04.deb 
d.， 然后 运行 nand-sata-install 脚本 
rootOorangepi~##nand-sata-install 
e. 然后 选择 $S InstalyUpdate the bootloader on SD/eMIMC 


Choose an option: 


Current root: UUID=2b84c970-6860-4343-8cc9-b590bclce6d5 


2 Boot from eMMC - System on eMMC 


| 国 InstaLL/Update the bootLoader on SD/eMMC 


<Cancet> 


f ， 按 下 回 车 键 后 首先 会 弹出 一 个 Warring 
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eMMC and USB 0range Pi instaLLer V2.1.0 


This script wiLL update the bootLoader on 


< Mo > 


g， 再 按 下 回 车 键 就 会 开始 更 新 u-boot， 更 新 完 后 会 显示 下 面 的 信息 


Writing bootLoader 


Done . 


h. 然后 就 可 以 重启 开发 板 来 测试 uboot 的 修改 是 否 生效 了 
4.3. 编译 linux 内 核 


1) 运行 build.sh 脚本 ， 记 得 加 sudo 权限 


test(Otest:~/orangepli-build$ sudo ./build.sh 


2) 选择 Kernel package， 然 后 回 车 
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Choose an option 
Compite image | rootfs | kerneL | U-boot 


U-boot package 


Rootfs and alLtL deb packages 
FuULL 09 image for flLashing 


3) 接着 选择 开发 板 的 型 号 


Choose an option 


PLease choose a Board . 


orangepirl ALLwinner H2+ quad core 256MB RAM WiFi SPI 2XxETH 
orangepizero ALLwinner H2+ quad core 256MB/512MB RAM WiFi SPI 
orangepipc ALLwinner H3 quad core 1GB RAM 

orangepipcpLus ALLwinner H3 quad core 1GB RAM WiFi eMMC 
orangepione ALLwinner H3 quad core 512MB RAM 

orangepiLite ALLwinner H3 quad core 512MB RAM WiFi 
orangepipLus ALLwinner H3 quad core 1GB/2GB RAM WiFi GBE eMMC 
orangepipLus2e ALLwinner H3 quad core 2GB RAM WiFi GBE eMMC 
orangepizeropLus2h3 ALLwinner H3 quad core 512MB RAM WiFiVBT eMMC 
orangepipc2 ALLwinner H5 quad core 1G6B RAM GBE SPI 
orangepiprime ALLwinner H5 quad core 2GB RAM GBE WiFiVBT 


orangepizeropLus ALLwinner H5 quad core 512MB RAM GBE WiFi SPI 
orangepizeropLus2h5 ALLwinner H5 quad core 512MB RAM WiFi/VBT eMMC 
orangepi3 H6 quad core 1GB/2GB RAM GBE WiFiVBT eMM( 
orangepiLite2 ALLwinner 


wlInner 


H6 


quad core 16B RAM WiFi/VBT USB3 
orangepionepLus ALLwinner H6 quad core 1GB RAM GBE 
orangepizero2 ALLwinner H616 quad core 512MB/1GB RAM WiFi/BT GBE SPI 


4) 然后 选择 分 文 
a._current 会 编译 linux $.4 
b. legacy 会 编译 linux4.9 


Choose an option 


SelLect the target kerneL branch 


current Recommended. Come with best EN 


5) 然后 会 弹出 通过 make menuconfig 打开 的 内 核 配 置 的 界面 , 此 时 可 以 直接 修改 内 
核 的 配置 ， 如 果 不 需 要 修改 内 核 配置 ， 直 接 退 出 即 可 ， 退 出 后 会 开始 编译 内 核 源码 
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Linux/arm64 4.9.118 KerneL Configuration 
Arrow keys navigate the menu. <Enter> seLects Submenus ---> (or empty submenus ----). 
HighLighted Letters are hotkeys. Pressing <Y> incLtudes，<N> excLudes，<M> moduLarizes 
features. Press <EsC><Esc> to exit，<?> for HeLp，</> for Search.， Legend: [*] buitLt-in 
[ ] exctuded <M> modutle < > modutLe capablte 


| 目 。SeneraL setup ---> 


[*] EnablLe LoadabLe modulLe support  ---> 
[*] EnabtLe the bLock Layer  ---> 
PLatform seLection  ---> 
Bus Support  ---> 
KeFneL Features ， =-=> 
Boot options  ---> 
Userspace binary formats  ---> 
Power management options  ---> 
CPU Power Management  ---> 
Networking Support  ---> 
Device Drivers  ---> 
Firmware Drivers  ---> 
FiLe Systems  ---> 
VirtuaLization ---- 
KerneL hacking  ---> 
Security options  ---> 
cryptographic API  ---> 
Library routines  ---> 


< Exit> <Help> <Save> <Load> 


a 如 果 不 需 要 修改 内 核 的 配置 选项 ， 在 运行 build.sh 脚本 时 ， 传 入 
KERNEL_CONEFIGURE=no 就 可 临时 屏蔽 弹出 内 核 的 配置 界面 了 
test(test:~/orangepi-build$y sudo ./build.sh 下 ERNEL CONFIGURE=no 

b.， 也 可 以 设置 orangepi-build/userpatches/config-defaultconf 配置 文件 中 的 
KERNEL _ CONFIGURE=no， 这 样 可 以 永久 禁用 这 个 功能 

c， 编译 内 核 的 时 候 如 果 提 示 下 面 的 错误 ， 这 是 由 于 Ubuntu PC 的 终端 界面 太 
小 ， 导 致 make menuconfig 的 界面 无 法 显示 ， 请 把 Ubuntu PC 的 终端 调 到 最 大 ， 然 
后 重新 运行 build.sh 脚本 
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HOSTCC scripts/kconfiLg/mconf.o 
HOSTCC scripts/kconfig/LxdiaLog/checkList.o 
HOSTCC scripts/kconfiLg/LxdiaLog/utiLL.o 
HOSTCC scripts/kconfig/LxdiaLog/inputbox.o 
HOSTCC scripts/kconfig/LxdiaLog/textbox.o 
HOSTCC Scripts/kconfig/LxdiaLog/yesno.o 
HOSTCC _ Scripts/kconfig/LxdiaLog/menubox.o 
HOSTLD  _ scripts/kconfiLg/mconf 
scripts/kconfio/mconf _Kconfia 
Your dispLay is too SmaLL to run Menuconfigl! 
IE must De at [east I9 [tnes Dy 856 COULUmns . 
scripts/kconfig/MakefiLe:28: recipe for target 'menuconfig'” faiLed 
make[1]: *** [menuconfig] Error 1L 
MakefiLe:560: recipe for target 'menuconfiLg” faiLed 
make: *** [menuconfig] Error 2 
] ERROR in function CompiLe_kerneL [ 
] Error kerneL menuconfig faiLed 
] Process terminated 


6) 编译 内 核 源 码 时 提示 的 部 分 信息 说 明 如 下 《以 legacy 分 支 为 例 ) 
a， linux 内 核 源码 的 版 本 
[ o.Kk. ] Complling legacy kernel [ 4.9.118 ] 
b. 使 用 的 交叉 编译 工具 链 的 版 本 
[ o.Kk. ] Compller verslon [ aarch64-none-linux-gnu-gcc 9.2.1 ] 
c. 内 核 默认 使 用 的 配置 文件 以 及 它 存放 的 路 径 
[ o.Kk. ] Using kernel config file [ config/kernellinux-sunSOiw6-legacy.config | 
d.， 如 果 设 置 了 KERNEL CONFIGURE=yes， 内 核 最 终 使 用 的 配置 文件 .config 
会 复制 到 outputconfig 中 ， 如 果 没 有 对 内 核 配 置 进行 修改 ， 最 终 的 配置 文 
件 和 默认 的 配置 文件 是 一 致 的 
[ o.k. ] Exporting new kernel config [ output/config/linux-sunSgOiw6-legacy.config ] 
e. 编译 生成 的 内 核 相 关 的 deb 包 的 路 径 
[ o.Kk. ] Target directory [ output/debs/ ] 
f 编译 生成 的 内 核 镜 像 deb 包 的 包 名 
[ ok. ] File name [ linux-image-legacy-SsunSgOiw6 2.1.0 arm64.deb | 
g.， 编译 使 用 的 时 间 
[ok. ] Runtime [Smin |] 
h. 最 后 会 显示 重复 编译 上 一 次 选择 的 内 核 的 编译 命令 , 使 用 下 面 的 命令 无 需 通 
过 图 形 界 面 选 择 ， 可 以 直接 开始 编译 内 核 源 码 
[ o.Kk. ] Repeat Build Options [ sudo .build.sh BOARD=orangepi3 BRANCH=legacy 
BUILD OPT=kernel KERNEL _ CONEFIGURE=yes | 


7) 碍 看 编译 生成 的 内 核 相 关 的 deb 包 
a、 linux-dtb-legacy-sunSg0iw6 2.1.0_arm64.deb 包含 内 核 使 用 的 dtb 文件 
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blinux-headers-legacy-sunS0iw6 2.1.0_ arm64.deb 包含 内 核 头 文件 
c， linux-image-legacy-sunSgiw6 2.1.0_ arm64.deb 包含 内 核 镜 像 和 内 核 模块 


test(Otest:~/orangepli-build$y ls output/debs/linux-* 
output/debs/linux-dtb-legacy-sunS0iw6 2.1.0_arm64.deb 
output/debs/linux-headers-legacy-sun50Iw6 2.1.0_arm064.deb 
output/debs/linux-image-legacy-sun50iw6 2.1.0_arm64.deb 


8) 生成 的 linux-image 的 deb 包 包 含 的 文件 如 下 所 示 
a. 使 用 下 面 的 命令 可 以 解压 deb 包 


test(Otest:~/orangepi-bulild$ cd outputdebs 
test(Otest:~/orangepl_ build/output/debs$ mkdir test 
test(Otest:~/orangepl_ build/output/debs$ cp 、 
linux-image-legacy-SsunSOiw6 2.1.0_arm04.deb test/ 
test(Otest:~/orangepl _ build/output/debs$ cd test 
test(Otest:~/orangepl_ build/output/debs/test$ dpkg -X\ 
linux-image-legacy-SsunS0iw6 2.1.0_ arm04.deb . 
test(Otest:~/orangepl _ build/output/debs/test ls 


boot etc lib 1lnux-image-legacy-sun30iw6 2.1.0_ arm64.deb usST 


b.， 解压 后 的 文件 如 下 所 示 


test(Otest:~/orangepl build/output/debs/test tree -L 2 


上 一 boot 

| “上 一 config-4.9.118-sun50iw6 /编译 内 核 源码 使 用 的 配置 文件 
| “上 一 System.map-4.9.118-sun50iw6 

| “一 vmlinuz-4.9.118-sun50iw6 /编译 生成 的 内 核 镜像 文件 

上 一 etc 

[一 kernel 

上 一 It 

| “L- 一 modules /编译 生成 的 内 核 模块 

上 一 linux-image-legacy-sun50iw6_ 2.1.0_arm64.deb 

上 -一 UST 


上 一 节 


上 -一 share 


8 directories, 4 files 
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9) orangepi-bulid 编译 系统 编译 linux 内 核 源 码 时 首先 会 将 lnux 内 核 源 码 和 github 
服务 器 的 linux 内 核 源 码 进行 同步 ， 所 以 如 果 想 修改 linux 内 核 的 源码 ， 首 先 需要 关 
财源 码 的 更 新 功能 〈 需 要 完整 编译 过 一 次 linux 内 核 源码 后 才能 关闭 这 个 功能 ， 否 
则 会 提示 找 不 到 linux 内 核 的 源码 ) ， 和 否则 所 作 的 修改 都 会 被 还 原 ， 方 法 如 下 : 

设置 userpatches/config-defaultconf 中 的 IGNORE _ UPDATES 变量 为 “yes?” 
test(Otest:~/orangepli-build$ vim userpatches/config-default.conf 
IOGNORE _ UPDATES="yes"” 


10) 如 果 对 内 核 做 了 修改 , 可 以 使 用 下 面 的 方法 来 更 新 开发 板 linux 系统 的 内 核 和 内 
核 模 块 

a 将 编译 好 的 linux 内 核 的 deb 包 上 传 到 开发 板 的 linux 系统 中 
test(Otest:~/orangepi-build$ cd outputdebs 


test(Otest:~/orangepli-bulild/output/debs$ scp 、\ 
linux-image-legacy-sunSOiw6 2.1.0_arm04.deb root@192.108.1.207:/root 
b.， 然后 登录 到 开发 板 ， 凶 载 已 安装 的 lnux 内 核 的 deb 包 
rootOorangepi:~##apt purge -y linux-image-legacy-SunSOiw6 
c. 再 安装 刚才 上 传 的 新 的 linux 内 核 的 deb 包 
root(Oorangepi:~##dpkg -ilinux-image-legacy-sunSgiw6 2.1.0_ arm04.deb 
d， 然后 重启 开发 板 ， 再 查看 内 核 相关 的 修改 是 否 已 生效 


11) 安装 内 核 头 文件 到 linux 系统 中 的 方法 如 下 所 示 
a. 将 编译 好 的 linux 头 文件 的 deb 包 上 传 到 开发 板 的 linux 系统 中 
test(Otest:~/orangepi-bulild$ cd outputdebs 


test(Otest:~/orangepl-build/output/debs$ scp、\ 
linux-headers-legacy-sunS0iw6 2.1.0 arm064.deb root@192.168.1.207:/root 

b， 然后 登录 到 开发 板 ， 安 装 刚 才 上 传 的 的 linux 头 文件 的 deb 包 
rootOorangepi:~##dpkg -ilinux-headers-legacy-sunS0ivw6 2.1.0_ arm64.deb 

c。 安装 完 后 在 /usrsre 中 就 可 以 看 到 刚才 安装 的 内 核 头 文件 相关 的 内 容 了 
root@Oorangepi:~#]s /usr/src 
linux-headers-4.9.118-sunS0iw6 
rootorangepi:~#]s /usr/src/linux-headers-4.9.118-sunSgOiw0 


Documentation Module.symvers certs firmware init lb net Security UST 


Kconfig arch crypto 名 ipc mm samnples Sound virt Makefile block 


drivers include kernel modules Scripts tools 
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4. 4 编译 rootfs 


1) 运行 build.sh 脚本 ， 记 得 加 sudo 权限 
testtest:~/orangepi-build$y sudo .build.sh 


2) 选择 Rootfs and all deb packages， 然 后 回 车 


Choose an option 
CompitLe image | rootfs | kernelL | Uu-boot 


U-boot package 
KerneL package 


FuLL 05S image for fLashing 


3) 接着 选择 开发 板 的 型 号 


Choose an option 


PLease choose a Board . 


orangepir1l ALLwinner H2+ quad core 256MB RAM WiFi SPI 2xETH 
orangepizero ALLwinner H2+ quad core 256MB/512MB RAM WiFi SPI 
orangepipc ALLwinner H3 quad core 1GB RAM 

orangepipcpLus ALLwinner H3 quad core 1GB RAM WiFi eMMC 
orangepione ALLwinner H3 quad core 512MB RAM 

orangepiLite ALLwinner H3 quad core 512MB RAM WiFi 
orangepipLus ALLwinner H3 quad core 1GB/2GB RAM WiFi GBE eMMC 
orangepipLus2e ALLwinner H3 quad core 2GB RAM WiFi GBE eMMC 
orangepizeropLus2h3 ALLwinner H3 quad core 512MB RAM WiFiVBT eMMC 
orangepipc2 ALLwinner H5 quad core 1GB RAM GBE SPI 
orangepiprime ALLwinner H5 quad core 2GB RAM GBE WiFiVBT 


orangepizeropLus ALLwinner H5 quad core 512MB RAM GBE WiFi SPI 
orangepizeropLus2h5 ALLwinner H5 quad core 512MB RAM WiFi/VBT eMMC 
orangepi3 Al H6 quad core 1GB/2GB RAM GBE WiFi 
orangepiLite2 ALLwinner H6 quad core 16B RAM WiFiVBT USB3 
orangepionepLus ALLwinner H6 quad core 1GB RAM GBE 

orangepizero2 ALLwinner H616 quad core 512MB/1GB RAM WiFi/VBT GBE SPI 


wlInner 


4) 然后 选择 rootfs 的 类 型 


buster Debilian 10 
bionic Ubuntu 18.04 
focal buntu 20.04 


a linux4.9 支持 的 linux 发 行 版 如 下 所 示 


Choose an option 
SelLect the target 05S reLease package base 


190 Bust 
bionic Ubuntu Bionic 18.04 LTS 
focaL Ubuntu FocaL 20.04 LTS 


Www.orangepi.cn 124 Www.Xxunlong.tv 


有 深圳 市 迅 龙 软件 有 限 公 司 版 权 所 有 
b.， linxu$.4 支持 的 linux 发 行 版 如 下 所 示 


Choose an option 


Seltect the target 05 reLease package base 


buster Deblan 10 Buster 


focaL Ubuntu FocaL 20.04 LTS 


$) 然后 选择 镜像 的 类 型 
a、 Image with console interface (serveD 表 示 服 务 器 版 的 镜像 ， 体 积 比 较 小 
b， Imasge with desktop environment 表示 带 桌 面 的 镜像 ， 体 积 比 较 大 


Choose an option 


SelLect the target image type. 


Imadqe with consoLe interface 


Image with desktop environment 


6) 如 果 是 编译 服务 器 版 的 镜像 ， 还 可 以 选择 编译 Standard 版 本 或 者 Minimal 版 本 ， 
Minimal 版 本 预 装 的 软件 会 比 Standard 版 本 少 很 多 


Choose an option 
SelLect the target image type. 


Standard image with consoLe interface 
MinimaL image with consolLe interface 


7) 选择 镜像 的 类 型 后 就 会 开始 编译 root， 编 译 时 提示 的 部 分 信息 说 明 如 下 
arootfs 的 类 型 
[ o.Kk. ] local not found [ Creating new rootfs cache for focal |] 
b. 编译 生成 的 rootfs 压缩 包 的 存放 路 径 
[ o.K. ] Target directory [ externalcache/rootfs | 
c. 编译 生成 的 rootfs 压缩 包 的 名 字 
[ o.K. ] File name [ focal-cli-arm04.1S3618961fl14c28107ca023429aa0eb9.tarlz4 ] 
d， 编译 使 用 的 时 间 
[ ok. ] Runtime [13 min |] 
e.， 重复 编译 root& 的 命令 ,使 用 下 面 的 命令 无 需 通过 图 形 界 面 选 择 ， 可 以 直接 
开始 编译 rootfs 
[ o.Kk. ] Repeat Build Options [ sudo .build.sh BOARD=orangepi3 BRANCH=legacy 
BUILD OPTI=rootfs RELEASE=focal BUILD MINIUMAL=no 
BUILD DESKTOP=no KERNEL CONEFIGURE=vyes ] 
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8) 查看 编译 生成 的 rootfs 压缩 包 
a. focal-cli-arm64.153618961fl4c28107ca023429aa0eb9.tar.lz4 是 rootf 的 压缩 
包 ， 名 字 各 字段 的 含义 为 
a) focal 表示 rootfs 的 linux 发 行 版 的 类 型 
b) el 表示 rootfs 为 服务 器 版 的 类 型 ， 如 果 为 dekstop 则 表示 栗 面 版 类 型 
cj) arm64 表示 rootfs 的 架构 类 型 
d) 1S3618961fl4c28107ca023429aa0eb9 是 由 rootfs 安装 的 所 有 软件 包 的 包 
名 生成 的 MD5 哈 希 值 ， 只 要 没有 修改 root& 安装 的 软件 包 的 列表 ， 那 
么 这 个 值 就 不 会 变 ， 编 译 脚本 会 通过 这 个 MD5S 哈 希 值 来 判断 是 否 需 要 
重新 编译 rootfs 
b. focal-cli-arm64.153618961fl4c28107ca023429aa0eb9.tar.1z4.list 列 出 了 rootfs 
安装 的 所 有 软件 包 的 包 名 
test(Otest:~/orangepli-build$ ls external/cache/rootfs/ 
focal-cli-arm64.153618961fl4c28107ca023429aa0eb9.tar.1z4 
focal-cli-arm64.133618961fl4c28107ca023429aa0eb9.tar.1z4.list 


9) 如 果 需 要 的 root&s 在 external/cache/rootfs 下 已 经 存在 , 那么 再 次 编译 rootfs 就 会 
直接 跳 过 编译 过 程 ， 不 会 重新 开始 编译 ， 编 译 镜 像 的 时 候 也 会 去 
external/cache/rootfs 下 查找 是 否 已 经 有 缓存 可 用 的 rootfs， 如 果 有 就 直接 使 用 ， 这 
样 可 以 节省 大 量 的 下 载 编 译 时 间 


10) 由 于 编译 rootfs 的 时 间 较 长 ， 如 果 不 想 从 头 开 始 编译 rootfs ， 或 者 编译 rootfs 的 
过 程 有 问题 ， 可 以 直接 下 载 Orange Pi 缓存 的 rootfs 压缩 包 ，rootf 压缩 包 百 度 云 盘 
的 下 载 链接 如 下 所 示 , 下 载 好 的 rootfs 压缩 包 (〈 不 要 解压 哦 ) 需要 放 在 orangepi-build 
的 external/cache/rootfs 目录 下 才能 被 编译 脚本 正常 使 用 
链接 : https:/pan.baidu.com/MlvWQmCmSYdH7iCDFyKpJtVw 
提取 码 : zero 


spi-build 


toolchains.tar.9z 1.716 


orangepHbu 对 .tar.gz 151.7M 


Www.Orangepi.cn 127 WwWw.Xunlong.tv 


艺 range Pi 用 户 手册 深圳 市 迅 龙 软 件 有 限 公 司 版 权 所 有 


4.5. 编译 linux 镜像 


1) 运行 build.sh 脚本 ， 记 得 加 sudo 权限 
testOtest:~/orangepi-build$y sudo .build.sh 


2) 选择 Full OS imasge for flashing， 然 后 回 车 


Choose an option 
CompitLe image | rootfs | kernelL | Uu-boot 


U-boot package 
KerneL package 
Rootfs and alLL deb packages 


日 
1 


3) 然后 选择 开发 板 的 型 号 


Choose an option 


PLease choose a Board . 


orangepir1l ALLwinner H2+ quad core 256MB RAM WiFi SPI 2xETH 
orangepizero ALLwinner H2+ quad core 256MB/512MB RAM WiFi SPI 
orangepipc ALLwinner H3 quad core 1GB RAM 

orangepipcpLus ALLwinner H3 quad core 1GB RAM WiFi eMMC 
orangepione ALLwinner H3 quad core 512MB RAM 

orangepiLite ALLwinner H3 quad core 512MB RAM WiFi 
orangepipLus ALLwinner H3 quad core 1GB/2GB RAM WiFi GBE eMMC 
orangepipLus2e ALLwinner H3 quad core 2GB RAM WiFi GBE eMMC 
orangepizeropLus2h3 ALLwinner H3 quad core 512MB RAM WiFiVBT eMMC 
orangepipc2 ALLwinner H5 quad core 1GB RAM GBE SPI 
orangepiprime ALLwinner H5 quad core 2GB RAM GBE WiFiVBT 


orangepizeropLus ALLwinner H5 quad core 512MB RAM GBE WiFi SPI 
orangepizeropLus2h5 ALLwinner H5 quad core 512MB RAM WiFi/VBT eMMC 


QU 
1Ua 


orangepiLite2 ALLwinner H6 quad core 1GB RAM WiFiVBT USB3 
orangepionepLus ALLwinner H6 quad core 1GB RAM GBE 
orangepizero2 ALLwinner H616 quad core 512MB/1GB RAM WiFi/VBT GBE SPI 


4) 然后 选择 rootfs 的 类 型 


buster Debian 10 
bionic Ubuntu 18.04 
focal buntu 20.04 


a linux4.9 支持 的 linux 发 行 版 如 下 所 示 
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Choose an option 
SelLect the target 05S reLease package base 


buster Deblan 10 Buster 
bionic Ubuntu Bionic 18.04 LTS 
focaL Ubuntu FocaL 20.04 LTS 


blinxu5.4 支持 的 linux 发 行 版 如 下 所 示 


Choose an option 


SeltLect the target 05 reLease package base 


Debian 10 Buster 


Ubuntu Focat 26.64 LTS 


buster 
focal 


$) 然后 选择 镜像 的 类 型 
a、 Image with console interface (serveD 表 示 服 务 器 版 的 镜像 ， 体 积 比 较 小 
b， Imasge with desktop environment 表示 带 桌面 的 镜像 ， 体 积 比 较 大 


Choose an option 


SelLect the target image type. 


Image with desktop environment 


6) 如 果 是 编译 服务 器 版 的 镜像 ， 还 可 以 选择 编译 Standard 版 本 或 者 Minimal 版 本 ， 
Minimal 版 本 预 装 的 软件 会 比 Standard 版 本 少 很 多 


Choose an option 
SelLect the target image type. 


image with consoLe interface 
MinimaL image with consolLe interface 


7) 选择 镜像 的 类 型 后 就 会 开始 编译 linux 镜像 ， 编 译 的 大 致 流程 如 下 
a 初始 化 Ubuntu PC 的 编译 环境 ， 安 装 编译 过 程 需要 的 软件 包 
下 载 wboot 和 linux 内 核 的 源码 〈 如 果 已 经 缓存 ， 则 只 更 新 代码 ) 
编译 u-boot 源码 ， 生 成 upboot 的 deb 包 
编译 linux 源码 ， 生 成 linux 相关 的 deb 包 
制作 linux firmware 的 deb 包 
制作 orangepi-config 工具 的 deb 包 
制作 板 级 文 持 的 deb 包 
如 果 是 编译 desktop 版 镜像 ， 还 会 制作 desktop 相关 的 deb 包 
i 检查 rootfs 是 否 已 经 缓存 ， 如 果 没 有 缓存 ， 则 重新 制作 root， 如 果 已 经 组 
存 ， 则 直接 解压 使 用 
j 安装 前 面 生成 的 deb 包 到 rootfs 中 


中 5 
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k.， 对 不 同 的 开发 板 和 不 同类 型 镜像 做 一 些 特定 的 设置 ， 如 预 装 额 外 的 软件 包 ， 
修改 系统 配置 等 

1 然后 制作 镜像 文件 ， 并 格式 化 分 区 ， 默 认 类 型 为 ex 妇 

再 将 配置 好 的 rootfs 拷贝 到 镜像 的 分 区 中 

然后 更 新 initramfs 

最 后 将 uboot 的 bin 文件 通过 dd 命令 写 入 到 镜像 中 


2 8 8 


8) 编译 完 镜像 后 会 提示 下 面 的 信息 《以 legacy 分 支 为 例 ) 

a. 编译 生成 的 镜像 的 存放 路 径 
[ ok. ] Done building 
[outputimages/orangepi3 2.1.0 ubuntu _ focal server_ linux4.9.118/orangepi3 2.1.0 


Lubuntu focal server linux4.9.118.img ] 
b. 编译 使 用 的 时 间 
[ o.k. ] Runtime [ 19 min ] 
c， 重复 编译 镜像 的 命令 , 使 用 下 面 的 命令 无 需 通过 图 形 界面 选择 , 可 以 直接 开 
始 编译 镜像 
[ o.Kk. ] Repeat Build Options [ sudo .build.sh BOARD=orangepi3 BRANCH=legacy 
BUILD OPT=image RELEASE=focal BUILD MINIMAL=no 
BUILD DESKTOP=no 下 ERNEL _ CONEFIGURE=yes |] 


S. Android 系统 使 用 说 明 


5. 1. 已 支持 的 Android 版 本 


Android 版 本 内 核 版 本 
Android 7.0 linux3.10 


5.2.， Android 7.0 功能 适 配 情 况 


功能 状态 
HDMI 视频 OK 
HDMI 音频 OK 
USB2.0 OK 
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USB3.0x4 OK 
TF 卡 启 动 OK 
EMMC 启动 OK 
网 卡 OK 
红外 OK 
WIFI OK 
WIFI hotsport OK 
尼 训 大 OK 
蓝牙 耳机 OK 
BLE 效 牙 OK 
耳机 音频 OK 
CVBS 视频 OK 
USB 摄像 头 OK 
LED 灯 OK 
温度 传感器 OK 
Mali GPU OK 
视频 编 解 码 OK 
电源 按键 OK 
ADB 调试 OK 
mini PCIE NO 
5. 3， 板 载 LED 灯 显 示 说 明 
黄 灯 红 灯 
u-boot 启动 阶段 灭 亮 
内 核 启动 到 进入 系统 亮 灭 
GPIO 口 PL7 PL4 


5.4.。 ADB 的 使 用 方法 


5. 4. 1. 


打开 USB debugging 选项 


ID) USB 调试 模式 默认 是 打开 的 , ADB 调试 默认 是 可 以 直接 使 用 的 , 如 果 ADB 使 用 
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2) 然后 选择 开发 者 选项 


广 无 障碍 


忆 3 


{} 开发 者 选项 


O 关于 机 项 盒 


3) 然后 打开 USB 调试 和 USB 切换 到 设备 模式 


调试 


USB0 切 换 到 设备 模式 入 @ 
切换 US80 到 设备 模式 ， 便 于 调试 


5. 4.2. 使 用 网 络 连接 adb 调试 

1) 使 用 网 络 adb 无 需 使 用 Micro USB 接口 的 数据 线 来 连接 电脑 和 开发 板 , 而 是 通过 
网 络 来 通信 ， 所 以 首先 请 确保 开发 板 的 有 线 或 者 无 线 网 络 已 经 连接 好 了 ， 然 后 获取 
开发 板 的 卫 地址 ， 后 面 要 用 到 


2) 确保 已 经 打开 USB debugging 选项 
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3) 确保 Android 系统 的 service.adb.tcp.port 设置 为 5555 端口 号 
petrel-p1:/##getprop | Srep "adb.tcpy" 
[service.adb.tcp.port]: [S335] 


4) 如 果 service.adb.tcp.port 没有 设置 ， 可 以 使 用 下 面 的 命令 设置 网 络 adb 的 端口 号 
petrel-p1:/##Setprop service.adb.tcp.port SSSS 

petrel-pl1:/##stop adbd 

petrel-p1:/#start adbd 


5) 在 Ubuntu PC 上 安装 adb 工具 
testtest:~$ sudo apt update 
testtest:~$ sudo apt install adb 


6) 然后 在 Ubuntu PC 上 连接 网 络 adb 
test@test:~$ adb connect 192.168.1.xxx (IIP 地 址 需要 修改 为 开发 板 的 耳 地 址 ) 


*# daemon not running; starting now at tcp:S037 


* daemon started successfully 
connected to 192.168.1.xxx:3335 


testtest:~ adb devices 
List of devlices attached 
192.168.1.xxx:S$$S5$ devilce 


7) 然后 在 Ubuntu PC 上 通过 adb shell 就 可 以 登录 android 系统 
testtest:~$ adb shell 
Ipetrel-p1:/ 北 


5. 4. 3， ”使 用 数据 线 连接 adb 调试 


1) 首先 确保 打开 USB debugging 选项 


2) 首先 需要 使 用 Micro USB 接口 的 数据 线 将 开发 板 连接 到 电脑 的 USB 接口 中 《请 
同时 使 用 DC 电源 给 开发 板 供电 ) 
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OTG 接 口 


3) 在 Ubuntu PC 上 安装 adb 工具 
Itest(Otest':~$ sudo apt update 
testtest:~$ sudo apt install adb 


4) 查看 识别 到 ADB 设备 
testOtest:~$ adb devices 
List of devices attached 
20080411 device 


5$) 然后 在 Ubuntu PC 上 通过 adb shell 就 可 以 登录 android 系统 
testOtest~$ adb shell 
Ipetrel-p1:/# 


5.5._HDMI 4K 显示 说 明 


1) 如 果 开 发 板 的 HDMI 接 到 不 文 持 4K 的 电视 上 或 者 显示 器 上 , 在 设置 中 虽然 能 查 
看 到 HDMI 支持 的 分 辨 率 有 4K 相关 的 选项 ， 但 是 是 无 法 使 用 的 
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HDMI 输 出 模式 


1080P_60Hz 
1080P_24Hz 


1080P_25Hz 


4K_25Hz 
4K_30Hz 


4K_50Hz 


@ 
O 
O 
〇 4k24hz 
O 
@ 
O 〇 
| 


4K_60Hz 


在 1080p 的 电视 中 选择 4K 选项 会 提示 HDMI 输出 模式 不 文 持 


修改 提示 
当前 电视 HDMI 输 出 模式 不 支持 


2) 只 有 将 开发 板 的 HDMI 接 到 支持 4K 的 电视 上 或 者 显示 器 上 ，HDMI 4K 相关 的 
分 辩 率 选项 才能 正常 使 用 


5. 6._ USB 摄像 头 使 用 方法 


1) 先 在 开发 板 的 USB 接口 中 插入 USB 摄像 头 ， 然 后 确认 下 USB 摄像 头 相关 的 内 
核 模 块 已 正常 加 载 

petrel-pl1:/##lsmod 

Module Size Used by 

bcmdhd 943519 0 
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bcm_ btipm rc 7412 0 

uvcvideo 084600 0 

videobuf2 vmalloc 3203 Tuvcvideo 

videobuf2 memops 2091 1yvideobuf2 vmalloc 
videobuf2_ core 31877 Tuvecvideo 


2) USB 摄像 头 如 果 识 别 正常 ， 在 /dev 下 会 生成 相应 的 video 设备 节点 


petreL-p1:/ # LS /dev/Vvideor 
/dev/videog 
petreL-pI:/ # LSs /Sys/cLass/video4Linux/ -Lh 


total 9 
Lrwxrwxrwx 1 root root 0 2020-12-98 15:58 videog -> ../../devices/soc/5311000.ehci3-controLLer/usb2/2-1/2-1:1.9/video4Linux/videog 


Petrer-pI:7 区 重 


3) 然后 确保 Ubuntu PC 和 开发 板 的 adb 连接 正常 


4) 在 Orange Pi 3 的 资料 下 载 页 面 的 官方 工具 中 下 载 USB 摄像 头 测试 APP 


图 spcrdromattevs wnEN.zp 


5) 然后 使 用 adb 命令 安装 USB 摄像 头 测试 APP 到 Android 系统 中 ， 当 然 也 可 以 使 
用 U 盘 找 贝 的 方式 进行 安装 
testtest:~$ adb install usbcamera.apk 


6) 安装 完 后 在 Android 的 桌面 中 可 以 看 到 USB 摄像 头 的 启动 图 标 
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一 


WebView Shell iefox US8 摄 像 头 


Android 旬 盘 (AOSP) 


7) 然后 双击 打开 USB 摄像 头 APP 就 可 以 看 到 USB 摄像 头 的 输出 视频 了 
5.7. Android 系统 ROOT 说 明 


Orange Pi 发 布 的 Android 7.0 系统 已 经 ROOT， 可 以 使 用 下 面 的 方法 来 测试 


1) 在 Orange Pi 3 资料 下 载 页 面 的 官方 工具 中 下 载 rootcheck.apk 
STR 


b 2020-05-14 12:27 ”失效 时 间 : 永久 有 效 


返回 上 一 航 | 全 部 文件 ”官方 工具 


贺 phoenxcard v4.1.2.mr 12.8M 2019-12-16 16:08 


2) 然后 确保 Ubuntu PC 和 开发 板 的 adb 连接 正常 


3) 然后 使 用 adb 命令 安装 rootcheck.apk 到 Android 系统 中 , 当然 也 可 以 使 用 U 盘 找 
贝 的 方式 进行 安装 
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testtest:~$ adb install rootcheck.apk 


4) 安 闭 完 后 在 Android 的 桌面 可 以 看 到 ROOT 测试 工具 的 局 动 图 标 


5) 第 一 次 打开 ROOT 测试 工具 后 的 显示 界面 如 下 图 所 示 


Root 测试 工具 


Root 状态 


装置 
作业 系统 


未 检查 


6) 然后 就 可 以 点 击 “ 立 刻 检查 ”开始 Android 系统 的 ROOT 状态 的 检查 ， 检 查 完 后 
的 显示 如 下 所 示 ， 可 以 看 到 Android 系统 已 取得 ROOT 权限 


Root 测试 工具 


Root 状态 
装置 Ailwinner molly 
作业 系统 0 2 03-01 (API24 
已 取得 ROOT 
立刻 检查 
Root 资讯 
Root 存 取 


SELinux 
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6. Android SDK 使 用 说 明 


1) Android SDK 的 编译 是 在 安装 有 Ubuntu 14.04 的 PC 上 进行 的 ， 其 它 版 本 的 
Ubuntu 系统 可 能 会 有 一 些 区 别 


2) Android SDK 是 芯片 厂商 释放 的 原始 的 SDK， 如 果 想 在 Orange Pi 开发 板 上 使 用 
Android SDK 编 出 来 的 Android 镜像 ， 需 要 针对 不 同 的 板子 进行 适 配 ， 才 能 保证 所 
有 功能 使 用 正常 


6. 1. 下 载 Android SDK 的 源码 


1) 首先 从 百度 云 盘 下 载 Android SDK 的 分 卷 压 缩 包 


H6 Sol 


巴 保 存 到 网 盘 


2) Android 源码 包 下 载 完 后 ， 首 先 需要 将 多 个 压缩 文件 合并 成 一 个 ， 然 后 解压 
testtest:~$ mkdir OrangePiH6 

testtest:~$ cat H6-2018-1-2.tar.gzax > OrangePiH6.tar 

testtest:~$ tar xf OrangePiH6.tar -C OrangePiHo0 


6. 2. 搭建 Android 编译 环境 


1) 安装 JDK 
testOtest:~$ sudo add-apt-repository ppa:openjdk-rppa 


[testtest:~$ sudo apt-get update 
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testOtest:~$ sudo apt-get install openjdk-8-jdk 


也 


2) 配置 JAVA 环境 变量 
a 首先 确定 java 的 安装 路 径 ， 一 般 为 


test(Otest:~$ ls /usrlib/jvnyjava-8-openjdk-amd64 
ASSEMBLY _ EXCEPTION bin docs include Jre lib man Src.zip 
THIRD PARTY README 


纯 


b， 然后 使 用 下 面 的 命令 导出 java 的 环境 变 


testOtest:~$ export JAVA_HOME=/usrlib/jvmy/java-8-openjdk-amd64 
testtest:~$ export PATH=$JAVA_HOME/bin:$PATH 
testtest:~$ export CLASSPATH=.:$JAVA_HOMUVlib:$JAVA_HOME/liby/tools.jar 


3) 安装 平台 支持 软件 


[testtest:~$ sudo apt-get update 

test(Otest:~$ sudo apt-get install git gnupg flex bison gperf build-essential \ 
zip curl zliblg-dev gcc-multilib c++-multilib libc0-dqev-i386 、\ 
lib32ncursesS-dev xl11proto-core-dev libxll-dev lib32z1-dev ccache 、\ 
libgl1-mesa-dev libxml2-utils xsltproc unzip 


testtest:~$ sudo apt-get install u-boot-tools 


6. 3. 编译 Android 镜像 


6.3.1.， 编译 内 核 


1) Android SDK 解 压 后 ， 在 解压 的 目录 下 会 有 andorid 和 1lichee 两 个 子 目 录 ，lichee 目 
录 主 要 内 容 如 下 所 示 


lichee/brandy/u-boot-2014.07 #uboot 代 码 目 录 
lichee/bootloaderuboot 2014 Sunxi spl #boot0 代码 目录 
lichee/linux-3.10 # 内 核 代 码 

lichee/tools # 方 案 硬件 配置 ， 打 包工 具 等 


2) lichee 的 编译 方法 如 下 所 示 


testOtest:~$ cd OrangePiH6/lichee 
test(Otest:~/OrangePiHO/lichee$ .build.sh config 
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Welcome to mkscript setup progress 
All available chips: 

0. sunS0iw1lpl 

. SunS0iw2p1 

. SunS0iw6p1l 

. Sun8iw1llp1l 

.Sun8iwl2p1l 

. Sun8iwop1l 

. Sun8iw7p1 


~] 小 上 WP 一 


. Sun8iw8p1l 
8. Sun9iw1lp1l 
Choice: 2 
All available platforms: 
0. androld 
1. dragonboard 
2. 1]inux 
3. eyeseelinux 
Choice: 0 
All available business: 
0. 5.1 
1. 4.4 
风 ， 了 交 
Choice: 2 


3) 编译 成 功 后 输出 内 容 如 下 所 示 


sunS0iw6p1l compile Kernel successful 
INFO: build kernel OK. 
INFO: build rootfs .… 


INFO: Skip make rootfs for android 
INFO: build rootfs OK. 


build sunS0iw6opl androlid 7.x lichee OK 
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6.3.2.， 编译 Android 源码 


1D) 编译 Android 的 命令 如 下 


testtest:~/OrangePiH69 cd android 
testtest:~/OrangePiH6/android$ source build/envsetup.sh 
testtest:~/OrangePiH6/android$ lunch petrel fvd_p1-eng 
testtest:~/OrangePiH6/android$ extract-bsp 
testtest:~/OrangePiH6/android$ make -j8 
test(Otest:~/OrangePiHO/androld$ pack 


2) 其 中 pack 命令 用 于 打包 生成 安 羊 固件， 如果 编译 打包 过 程 都 顺利 通过 ， 会 提示 
下 面 的 信息 


IDragon execute image.cfg SUCCESS ! 


OrangePiH6O/lichee/tools/packy/sunS0iw6p1l android_ petrel-pl_uart0.imsg 


pack finish 


3) 生成 的 安 卓 镜像 存放 的 路 径 为 


OrangePiH6O/lichee/tools/pack/sunS0iw6p1l android_ petrel-pl_uart0.imsg 
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